WG Review: Building Blocks for HTTP APIs (httpapi)

The IESG <iesg-secretary@ietf.org> Wed, 30 September 2020 16:04 UTC

Return-Path: <iesg-secretary@ietf.org>
X-Original-To: ietf-announce@ietf.org
Delivered-To: ietf-announce@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id A82923A0AE3; Wed, 30 Sep 2020 09:04:15 -0700 (PDT)
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
From: The IESG <iesg-secretary@ietf.org>
To: IETF-Announce <ietf-announce@ietf.org>
Subject: WG Review: Building Blocks for HTTP APIs (httpapi)
X-Test-IDTracker: no
X-IETF-IDTracker: 7.17.1
Auto-Submitted: auto-generated
Precedence: bulk
Cc: httpapi@ietf.org
Reply-To: iesg@ietf.org
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
Message-ID: <160148185559.24946.17875142176860266330@ietfa.amsl.com>
Date: Wed, 30 Sep 2020 09:04:15 -0700
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-announce/m_p1P_3wcZGdD1Ie5g6tAL9ovZA>
X-BeenThere: ietf-announce@ietf.org
X-Mailman-Version: 2.1.29
List-Id: "IETF announcement list. No discussions." <ietf-announce.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-announce>, <mailto:ietf-announce-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf-announce/>
List-Post: <mailto:ietf-announce@ietf.org>
List-Help: <mailto:ietf-announce-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-announce>, <mailto:ietf-announce-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 30 Sep 2020 16:04:16 -0000

A new IETF WG has been proposed in the Applications and Real-Time Area. The
IESG has not made any determination yet. The following draft charter was
submitted, and is provided for informational purposes only. Please send your
comments to the IESG mailing list (iesg@ietf.org) by 2020-10-10.

Building Blocks for HTTP APIs (httpapi)
-----------------------------------------------------------------------
Current status: Proposed WG

Chairs:
  Darrel Miller <darrel.miller@microsoft.com>
  Rich Salz <rsalz@akamai.com>

Assigned Area Director:
  Barry Leiba <barryleiba@computer.org>

Applications and Real-Time Area Directors:
  Barry Leiba <barryleiba@computer.org>
  Murray Kucherawy <superuser@gmail.com>

Mailing list:
  Address: httpapi@ietf.org
  To subscribe: https://www.ietf.org/mailman/listinfo/httpapi
  Archive: https://mailarchive.ietf.org/arch/browse/httpapi/

Group page: https://datatracker.ietf.org/group/httpapi/

Charter: https://datatracker.ietf.org/doc/charter-ietf-httpapi/

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.

New work items can be added after a Call for Adoption on the working group
mailing list and consultation with the Area Director. To assess whether the
group is functioning well in this mode, this charter will be reviewed by the
IESG nine months after chartering.

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.

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:
 
TDB