It's surprising how many REST APIs lack useful docs
It's surprising how many REST APIs lack useful docs.
Useful docs should include:
- BaseURLs for all environments
- Potential HTTP response codes
- Example requests and responses
- Required and optional headers
- Auth requirements
If a web API isn't documented, it's not done.