此篇文章將作為接下來一系列關於Restful API design的目錄．

Part 1: 將介紹什麼是API，何時需要他，以及怎樣才會是一個好的API．

Part 2: 在許多種API中，此系列只專注於HTTP RESTful API，為了更好地學習他，必須先了解HTTP Protocol，知道其中各個組成HTTP Message的每一個部分．

Part 3: 介紹何為RESTful API，為什麼他會長這樣，以及其他許多當你在設計API時會遇到情況，例如: Documentation、Pagination、Rate Limiting、Monitoring．

Part 4: 陸續想到一些相關的議題，再放上來！

Outline

1. Introduction
   • 1.1 What is an API?
   • 1.2 What is a good API?
2. HTTP Basics
   • 2.1 A HTTP Overview
   • 2.2 HTTP Methods
   • 2.3 HTTP Response status codes
   • 2.4 HTTP URI
   • 2.5 HTTP Headers
   • 2.6 [Practices] A HTTP client — curl
3. RESTful API and some Practical Guidelines
   • 3.1 What is a RESTful API?
   • 3.2 Identifying Resources
   • 3.3 API first principle and an introduction to OpenAPI
   • 3.4 [Practices] How do I manage a large OpenAPI spec file?
   • 3.5 Pagination
   • 3.6 Rate Limiting
   • 3.7 Monitoring
4. Advanced Topics
   • 4.1 Connection management
   • 4.2 Resource Modeling: Fine-grained or Coarse-grained?
   • 4.3 Versioning and Compatibility
   • 4.4 How to Response to a Health Check?