Documenting It

Write the five things. Base URL. Authentication, or that there is none. The rate limit, or that there is not one. How pagination works, with an example. What an error looks like, with an example.

That is a usable API document, and it is more than many production APIs manage. You know it is enough because it is exactly what you went looking for in module 3 and could not always find.

✦ An example request beats a schema

One real request and its real response teaches more in ten seconds than a page of field definitions. Include a copy-pasteable curl command that actually works, and keep it working.