Skip to main content

Building Blocks for HTTP APIs (httpapi)

WG Name Building Blocks for HTTP APIs
Acronym httpapi
Area Web and Internet Transport (wit)
State Active
Charter charter-ietf-httpapi-01 Approved
Document dependencies
Additional resources GitHub Repository
GitHub Organization
Zulip stream
Personnel Chairs Darrel Miller, Rich Salz
Area Director Francesca Palombini
Secretary Mark Nottingham
Mailing list Address httpapi@ietf.org
To subscribe https://www.ietf.org/mailman/listinfo/httpapi
Archive https://mailarchive.ietf.org/arch/browse/httpapi/
Chat Room address https://zulip.ietf.org/#narrow/stream/httpapi

Charter for Working Group

In addition to its use for web browsing, HTTP is often used for machine-to-machine communication, facilitated by HTTP APIs. This Working Group will standardise HTTP protocol extensions for use in such cases, with a focus on building blocks for separate or combined use.

Its output can include the following:

• Specifications for HTTP extensions that relate to HTTP APIs (typically, new HTTP header and/or trailer fields)

• Specifications for new message body formats, or conventions for their use in HTTP APIs (e.g., patterns of JSON objects)

• Best practices and other documentation for HTTP API designers, consumers, implementers, operators, etc.

Other items are out of scope. In particular, this WG will not take on work items for HTTP APIs for specific applications or services, and it will not define new HTTP extension points. APIs for HTTP itself (e.g., in clients and servers) are also out of scope.

To be successful, this Working Group will need to have active and broad representation from across the industry -- e.g., API gateway vendors (and other intermediaries), API consultants, API tool vendors, in-house API teams. Therefore, adopted proposals should have public support from multiple implementers and/or deployments before being sent to the IESG.

To assess whether the group is functioning well, this charter will be reviewed by the IESG nine months after chartering.

This Working Group will also need to coordinate closely with the HTTP Working Group, in particular when new methods and status codes are proposed. Work items that are more broadly applicable (e.g., for implementation in Web browsers) are likely to be more appropriate in the HTTP Working Group, but it is expected that coordination and discussion between the groups' Chairs and Area Director(s) will guide work items to the appropriate venue.

Milestones

Date Milestone Associated documents
Nov 2025 Enter WGLC draft-ietf-httpapi-authentication-link
Mar 2025 Enter WGLC draft-ietf-httpapi-patch-byterange
Jun 2024 Send to IESG draft-ietf-httpapi-deprecation-header
Jun 2024 Send to IESG draft-ietf-httpapi-api-catalog