D9 第四周 网路基础

当周进度

• NET101
• 从拉面店的贩卖机理解什麽是 API
• 从传纸条轻松学习基本网路概念
• Request 额外补充（超重要）
• 补充教材: CS75 (Summer 2012) Lecture 0 HTTP Harvard Web Development David Malan

NET101

这堂课主要回绕着 HTTP, TCP/IP, API 这些网路相关的知识。

跟我们最息息相关的应该就是 HTTP 的 request 和 response，这个在浏览器 devtool 打开来，应该都能很直接地看到。它们都有各自的 header 和 body。其实跟信封和信纸的感觉差不多， header 上面可能会写寄件人、收信地址、信封种类…等等资讯，然後真正的内容放在 body 这样。

request 和 response 的区别方式是看相对自己来说是「送出」还是「接收」？
client 的身分对应到一直发送 request 等待 response 的角色，而 server 就是一直等待 request 然後 response。client 是主动发起方，server 则是被动等待方。另外一种比较特别的叫做 p2p，那就是互相有来有往的那种，但网路大部分还是 client-server 的架构。

method 和 status code 相对来说会比较陌生，但 404 和 500 这两个错误讯息可能大家或多或少都有看过。其实熟悉之後会发现还蛮有逻辑的。method 的部分主要是在 API 呼叫才会有差别，因为近年来流行 RESTful API 的关系，会鼓励大家在开发的时候多用 GET, POST, PATCH, DELETE 之类的方式区分。详细可以参考 HTTP 请求方法 - HTTP | MDN

API 呼叫范例

const request = require('request')
const URL = "http://example.com"

request.get({ url: URL }, (err, res, body) => {
  if (res.statusCode >= 200 && res.statusCode < 300) {
    console.log(body)
  }
})

API 文件撰写

推荐两个用来写 API 的工具

• API Blueprint | API Blueprint
• REST API Documentation Tool | Swagger UI

抱歉今天时间有点小赶，有机会的话再补完整一些 ?