API Design Technicals

This contains my technicals about API design.

Contents:

• Versioning
• Layout
  • Single Endpoint
  • Function Endpoint
  • RFC-3986 Style
• Pragmatic REST
  • What is REST in the first place?
  • Method in the madness
  • As long as it makes sense, don’t let this bind you
• Authentication
• Security
  • User data should not be sniffable
  • User-set secrets should not be recoverable
• Deconstructing the Linode DNSManager API
  • What does this API achieve?
  • How does the API achieve this?
  • How is the API used?
  • Using the API in context
  • Shortfalls of the API
  • Re-engineering the API