Trends

Building blocks for HTTP APIs: IETF 109 Working Group Meeting

Building blocks for HTTP APIs

As discussed in a recent interview with Darrell Miller, one of the chairs of the new “Building Blocks for HTTP APIs” working group, this working group will be the first one explicitly addressing HTTP APIs within the Internet Engineering Task Force (IETF).

It will be interesting to see what this working group is taking on in terms of work items. The first round of proposals was presented at the inaugural meeting of this working group at the IETF 109 event in November 2020.

Proposed Drafts for the HTTP APIs Working Group

The first draft that was proposed is “RateLimit Header Fields for HTTP” by Roberto Polli and Alejandro Martinez Ruiz. This document defines the RateLimit-LimitRateLimit-Remaining, and RateLimit-Resetfields for HTTP, thus allowing servers to publish current request quotas and clients to shape their request policy and avoid being throttled out.

The following three drafts that were presented were all authored in collaboration with others, but in full disclosure, I certainly have a special interest in them because I contributed to them:

  • “The Deprecation HTTP Header Field” (authored with Sanjay Dalal): It defines the HTTP Deprecation response header field that can be used to signal to consumers of a URI-identified resource that the resource has been deprecated. Additionally, thedeprecation link relation can be used to link to a resource that provides an additional context for the deprecation, and possible ways in which clients can find a replacement for the deprecated resource.

If you’re interested in a presentation of the drafts, here is a video of my presentation at the IETF 109 meeting. Additionally, if you’re interested in the feedback and discussions about the individual drafts, the HTTPAPI WG Meeting notes summarize everything that happened during the WG meeting.

Read my previous post detailing Building Blocks for HTTP APIs.