Document your endpoints in a consistent, scannable format so nothing is ambiguous.
Each method gets a heading, a description, and an example.
Explain your auth flow once, then link to it everywhere.
Show the exact header and a copy-pasteable example.
List every error code and what it means. Predictable errors are a feature.
Be explicit about limits and how clients should back off.