API

SDK generators

• Speakeasy
• Stainless
• Fern

Documentation

• Mintlify
• Scalar

Resources

• Best practices for REST API design
  • use JSON
  • use nouns on verbs in API paths (/get_activities vs GET /activities)
  • nest resources for hiearchial objects
  • allow filtering, sorting, and pagination
  • version api with path prefixes
• Cats - CATS is a REST API Fuzzer and negative testing tool for OpenAPI endpoints. CATS automatically generates, runs and reports tests with minimum configuration and no coding effort. Tests are self-healing and do not require maintenance.
• API design showcase: OpenAI #api
• Idempotency keys @ Crunchy #api
  • also Simple internal idempotency by ID
• HTTP API design: 204 “No content” mildly harmful #api
• Evolving API Pagination at Slack #api #pagination
• How Did REST Come To Mean The Opposite of REST? #api
• The Bezos API Mandate: Amazon’s Manifesto For Externalization #api
• EasySDK - generate SDKs for your OpenAPI specs #apis #sdk
• Best practices for using webhooks #webhooks #api #events
• How to and how not to design REST APIs #api
• Advice for Operating a Public-Facing API #api
• Give me /events, not webhooks #webhooks #api #events
• Considerations for event APIs (versus webhooks) #webhooks #api #events
• API Design Style Guides, Guidelines and Best Practices
• Stainless - SDK generator, pricing is steep but it generates beautiful SDKs and is good place for inspiration
• API Guidelines in the Wild