Learn APIs by example
Every guide here runs against the OffenderSearch sandbox, so the examples are real requests and real responses, not toy data.
The guides
- RESTful API Example: One Request, One Response, Explained
- What Is an API? Definition, Examples and a Call You Can Run
- Webhooks vs API Polling: When Each One Is Right
- Free Public APIs for Developers: Lists, Data APIs and Ours
- API Key vs OAuth Client Credentials: Which to Use
- API Documentation Example: What Good Docs Look Like
- API Token Example: Create, Scope, Rotate and Revoke a Key
- Postman API Documentation: Public Workspace, Live Sandbox
- API Errors: Designing Codes a Client Can Act On
- Webhook Example: Receive, Verify and Retry in 40 Lines
- API Signature: HMAC Signing for Requests and Webhooks