REST APIs.

HTTP API design, conventions, and best practices. Covers 12 topics.

• REST APIs · 1 of 3

  HTTP Methods & Status Codes

  Which HTTP method replaces the whole target resource with the representation in the request body?

  AUPDATEBPATCHCPOSTDPUT

• REST APIs · 2 of 3

  Rate Limiting & Throttling

  Which status code is standard when a client exceeds an API rate limit?

  A429 Too Many RequestsB413 Content Too LargeC503 Service UnavailableD402 Payment Required

• REST APIs · 3 of 3

  API Versioning Strategies

  Comparing 'pinning the active revision in the URL path' with 'pinning it in a vendor media type', which subtle invariant is preserved by the media-type style and broken by the path style?

  Aone resource keeps a single canonical identifier valueBone client keeps working unchanged across breaking releasesCone resource keeps a single cache entry for every versionDone representation keeps a single format for all clients