IETF Logo Mail Archive

[httpapi] Re: RFC 9727 on api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs

Darrel Miller <darrel@tavis.ca> Sun, 15 June 2025 00:14 UTC

Return-Path: <darrel@tavis.ca>
X-Original-To: httpapi@mail2.ietf.org
Delivered-To: httpapi@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id 2326D3508EB7 for <httpapi@mail2.ietf.org>; Sat, 14 Jun 2025 17:14:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (1024-bit key) header.d=tavisdev.onmicrosoft.com
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id P-HUVU9sV8ji for <httpapi@mail2.ietf.org>; Sat, 14 Jun 2025 17:14:16 -0700 (PDT)
Received: from DM5PR21CU001.outbound.protection.outlook.com (mail-centralusazon11021075.outbound.protection.outlook.com [52.101.62.75]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id 89B523508EAA for <httpapi@ietf.org>; Sat, 14 Jun 2025 17:14:16 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=hXmxtbHKXjd46CDNc/XSckb3+DeniV9k2PmddJhAx4gTVohy+qn7vrFBLHpz1Ft2QKys5lyw+K+MccJ7HWUBSZCPW8uqDSOdUb1fHq792YcaXx7HsZdd21hhUzH5I3Zw4qubetTOUs77PMEUkm9B+gm4AIfB4izzpkhxNMLJC4f0pXD6a8wjrJI4RLsvHkJ0r+xCz/EVpbvn7kmFd5Kp7j454wNDlTW/3R4j1VxOPRt7GSp9W6YbGU9iypZXvfgwlj34tYuglsRFKRFFWg/jnPlstFUHIMgH6flXdQXldkCgoAtF30HYMyfL0fqcxgt5DzSkO6yGrGGrBiH+WCzilg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=uUKdUVRZgX7i++H+fM+2rgVat1p82rGZMiuedpmaRW8=; b=xyESQu3jAGhKoMs4I6AEdbMhlnwHaRP3KrS+hhhp3s7Z9Ikw3sXQpohCuvyOtMEToThBEt3LI8aTrSgHepbNsKyFME39fSvBiTBXjpyfSD00PTi/AtnMr3R4zBBOlXFnUhhtGx9c4jhD0R70G7xtDU7gPE+NhES1bTXLGUZpQpq5/2oRy5j5WxAA4NGSZIS5suPi7auEYcGX+QkdOtdhqeRUD425qZzyAqyHhPPKlJV+lmJeTqqI+Xt/kPfSMGoHlPYkHlS58DhYSUG6P6xMIwvVUx+rzFnNFmesPZbvwvg66xrXAUWBtPVcr0oME2bqUT1ksWjXAa8j8rfsTeaPTw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=tavis.ca; dmarc=pass action=none header.from=tavis.ca; dkim=pass header.d=tavis.ca; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tavisdev.onmicrosoft.com; s=selector2-tavisdev-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=uUKdUVRZgX7i++H+fM+2rgVat1p82rGZMiuedpmaRW8=; b=hFgiLAmNb1adCUPiQuVeGBeM3MfyV1q2cYAN6zr67Ju7G88sA8S8NqC2B1GW17qgD+Hpgs6SL4ILMdzd2zbWlPj+Z8dFoQXnE+gKrl3YLjcbv9kiXNRJ0y+BEohLT8+JRrA+l4+sSM3G1o9jz6YmIgPvOLx1Ugb+G4mnY6zcym8=
Received: from SJ2PR01MB8102.prod.exchangelabs.com (2603:10b6:a03:4fd::17) by DM8PR01MB6934.prod.exchangelabs.com (2603:10b6:8:13::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8813.19; Sun, 15 Jun 2025 00:14:12 +0000
Received: from SJ2PR01MB8102.prod.exchangelabs.com ([fe80::d952:e672:d6cd:458f]) by SJ2PR01MB8102.prod.exchangelabs.com ([fe80::d952:e672:d6cd:458f%5]) with mapi id 15.20.8722.027; Sun, 15 Jun 2025 00:14:12 +0000
From: Darrel Miller <darrel@tavis.ca>
To: "Salz, Rich" <rsalz=40akamai.com@dmarc.ietf.org>, "httpapi@ietf.org" <httpapi@ietf.org>
Thread-Topic: [httpapi] Re: RFC 9727 on api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs
Thread-Index: AQHb3TMHUkSZrDxgekecLOA3+3FGHbQDWP6q
Date: Sun, 15 Jun 2025 00:14:12 +0000
Message-ID: <SJ2PR01MB8102C6415A155BF54B7D1B5FA371A@SJ2PR01MB8102.prod.exchangelabs.com>
References: <20250613211803.054512673A2@rfcpa.rfc-editor.org> <MN2PR17MB40314F4658B3E455F41A97D3CD76A@MN2PR17MB4031.namprd17.prod.outlook.com>
In-Reply-To: <MN2PR17MB40314F4658B3E455F41A97D3CD76A@MN2PR17MB4031.namprd17.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
msip_labels:
authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=tavis.ca;
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: SJ2PR01MB8102:EE_|DM8PR01MB6934:EE_
x-ms-office365-filtering-correlation-id: c27673fd-94d8-42b1-e67a-08ddaba18e47
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;ARA:13230040|376014|1800799024|366016|38070700018|13003099007|8096899003|7053199007;
x-microsoft-antispam-message-info: Kn1Ri1ZwtAJiVOm4rX0T+PDnZA0pVGTB78FlVT8DmecnV2VxiYUB9fgDTcRmdJPOGSlhnKx3YW9XVYtfEUNOcemiHv6ECRBnBq1Q/+qiVS8HnuPP8G1sbzi0Rv4rZyb31EZKETXzUOpXwmf1BNKoCFOcUQCCrBfMqN6mJVZzZicttRPJlHsG4ooaed7t3MCcVE8R/UjBYaCxo4I/nz5XvD2v2PDh0s8cS1yUdVa7Hlkh+S6UyCEkx66XC8W+7P/5hnIF5MYvRbN2oooIWT0Ovhaa+4t1TdaBYSYNIXzCKBG2yjLUcPgqWBF9hj94st79Fo/z7FirCvh02dExgSbp2Yv9MwfaoexEK0u3CD4qnr6wxX0H+HV7N5OzvJqxF3SFQwVPFQfb9pQBu1KDcIyJS05+JlpvBbFCpOyzSHafKkKK7jGN5ZSpiwuK+kEUM0f1FIDXua7oDZHYgBzdQZzTQMguUskNHHg0pPt8LC+CZRr/AwhRvt/95c6kwi30YaTEgnnD1gKC8qMtMzBIIk6Yq8ha/mUvXLVygjpdCWom0iAr4wXIdfecGzKS6D/lZGPU7eAR22twnmTjROFZQjpJkXoHQaqIS1UMW2c7qgRtwhr68J8cmdAiNbM4GWZ/CCN7f0l+2kFhBRc5Nvh1ZgLQvaf+V5jjBXTw/YXkrEkXKJPM/paTfRVZ5k3FrU4aaH3HszuU7lZIIVFOjCYinuV1N/AQt3vxpzyxVv6pKtCJJRMeD4AB6SxJBMkakMVDI3yPffEVAAjU2bKmWkMEcjKdlJvS3OQ5IVwaydjBUkyYpUhTHYIRjiP5lb/bAbz++K2xZEyPBQz8LrbVZzeqMn5JGdv8jVCFf9Tj5++xE+oQ57bdI+EXbXU4/I9FwOoyTKNc5jzh7fgVHkIkEZxYvX/zuzH6N4f+Z6zgvCNBupgR4LE/F8EDk5pcvrKqYaKImy+IpdIB8zeP/JOokpUxenVpkzi6O2eoV1mUn79OrHo6iLc2/nPaHbZHJuNpDtPaxBtJ2hJdXw51JpTnZXFPhBBS9mPUwmLoh0+HsQuYU3uZS6mTNnt8UV4/bnpMImDYQl8N3U929mi+kcFUwALLIKldRQDS0q48xqRA/bN04yXSsPQI4bDDiMOCQMBUwkonT0b8voNMsbqlSCj9L4p+EInTEOCjoqDnYdtaz6qHhnUPNgdXhzxHaCSlswiUvfLKPjKnanSm4ABq1ZVKk+UBEy5bEk7gXklkfNtTIPNXMuLoMZvlbLvS/iyGRe01Vkvg0PWjHrDXkl+FzfrC0pOa+6SNva1iGfILya7e1mEt3a/WmsMoNyQqKbuJxao0zKtm52Wgv/StwORd+cA1paWr4wsga4vovkr82d2K1sGFL1caz1ZUhgLHxoVjb80qBw2s9KQv8xBPXm5R5CnfqksZ8863ZnvT6n1Ot4mtwMNHS5+IkTIj4/gznzOUdHb5EO89YtKyC4/0jXSkWLPUZb0KOd16q8/H4HBq85PmjMqQtZG7vUE=
x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:SJ2PR01MB8102.prod.exchangelabs.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(1800799024)(366016)(38070700018)(13003099007)(8096899003)(7053199007);DIR:OUT;SFP:1102;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: CbpIf7XEnDXLvy7ACN/X9AYqRNrZeJpUBJct6Hz5gxR9545VWWKisb3ZJy7PD935qZYv4ktt49++bTTxPQfB3CIwqGQ3jrO9pz9P8a6CBxDiyJa76CCamSpplqiEeOlYTjL9NP3LKOnplrTvHDdk+Z+AIJFQfK8M+cFIxe8HPDZZDq5k5cZuuaasSq1ytDQxvR3g3Fr9IrtOy6nreW3obapJ9TkQvNQUZ3Ml/2A2qshZGWe8lP2GK2mkkAOHxZla+WKxLhXerT2hUq6Igdy+IBHht1Y6NnYoLoTaSZIxlSFSpMMxchhlfDsPhdpimu/zicDKRGfB26Lws2axxl2Lu3F0+r1CuAsJDfAgBAajHnlYUuTmj3RKAuVLcxExUfc/tUa65OhSEdtnwHnJdRMwWYPOuS5097uoUQDjtRn9OCB1S7X4WIAZvGKzTjyX9zCV1Zw49c4PwEQq1fqNrJYlIin4zVCY1v2D8NWmJZ/dTVKJTZzaVwtuBOHWndN1gUbOsmrqWwScmmQ2kl69ukgEiKZVTtWbV/WzsS/J3SLypYiqjRdWv3C5Rc0jzBcBalC65TZmA3itIgmp2nkv8h9lsFMKv/Wcy/2DH2sxEqVWNUN6ZQtulCV0EfNCZIaFE2Ss2vbb9KDP/y2tdOhN+ahSEQaKutehabZ/lQMszSDQcM1Xcvo18KsLcYfiUBawlyyUzt6MkF9rtQFCTUlCKlZEpFgfvsK8dH0MDJ124NEteIOLvchF6CAKC+GP1QeUvwSmeNwfnAWrmqNSTiP7jqBSgEEYCmuklS5WkLAyffIxHXgDxgVxBqLo0jIxCm8twJsUeAb/iy16VFRNKGYuCG41RS9ZQlRxEMKBChC/ykidpof3CLx2f/8dRFuk+QHRkxtum3Jf7patkUPh5nptKqR2+uJ+ompP1i/kClF5K7/MQVtdZvq6ftcCE5Uul3Rgz9P09mbZiSFHbFWABUtJgXn89TQN+MzbYgKy90Uic1flTaIRDJ0h5/VR0sod/any1irmeBWEi+DA/hIEaOD1irfn81+PcCGotc/SSE/KVfs5hDj5zV+Fdr/BN49XEiOs56bLje3OyjSEPN+eQ2cObhXBYc4TZh2vtYT+MfbGC3aCN7lRi6KQB7n+cCJ5dhNft/GZBvvgJRSj4gFCy5W2t8qcIkO3gyzr0oKMC81wEBp2cmkuGqHUXCrthBgjzJ72syTdlwTgYwGhVcvtO+KAeSp2vIHwJ8H34lDGtSvzgB2+6iEQ/zpEZPDf4bO1FS/9HN09Bxgl4JtXqkKuNDckgoD3mQu2TKpX9WznbrtfIsAguFiKxO5Y26trAxjj2+5/IEuG9/33PoWiJNqF0kzxFTpXQXkaRmBSMyXHYh+b3koLOwyHCdmI7qNkMELffwm74XaPoHZ1oZ+7mGuR4KQkWxqLS3NO0i0mFElS4Um8e5CaPub6Yd+uVTb+SRASX4i1EFKnVCk+1SqAunooOmPARzrmrrvxmfmUTDBJEqWVQ+h6CVMhydg6qSdOECrbr8CBUibfsBTR1o5GvUY+1Mrr9qJ2w1Dd+fU/0K4zVFt93zz6C78=
Content-Type: multipart/alternative; boundary="_000_SJ2PR01MB8102C6415A155BF54B7D1B5FA371ASJ2PR01MB8102prod_"
MIME-Version: 1.0
X-OriginatorOrg: tavis.ca
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: SJ2PR01MB8102.prod.exchangelabs.com
X-MS-Exchange-CrossTenant-Network-Message-Id: c27673fd-94d8-42b1-e67a-08ddaba18e47
X-MS-Exchange-CrossTenant-originalarrivaltime: 15 Jun 2025 00:14:12.1183 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 8cea02ec-9788-4bac-a19b-3e782a3e9bb0
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: BJRrQPngHjeGbw1jIYw8w+eIkxTYFI5P4T5kxJqTmB/a8ElJCc3/ZH6XDXHD1DqA
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM8PR01MB6934
Message-ID-Hash: 7CQLWMAB7Q3HJONPLJALWI4XIFRLZZYO
X-Message-ID-Hash: 7CQLWMAB7Q3HJONPLJALWI4XIFRLZZYO
X-MailFrom: darrel@tavis.ca
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [httpapi] Re: RFC 9727 on api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/P8sTKFb47w5MUiEP8GFcjKK68vs>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Owner: <mailto:httpapi-owner@ietf.org>
List-Post: <mailto:httpapi@ietf.org>
List-Subscribe: <mailto:httpapi-join@ietf.org>
List-Unsubscribe: <mailto:httpapi-leave@ietf.org>

Awesome news. Excellent job Kevin.

Darrel
________________________________
From: Salz, Rich <rsalz=40akamai.com@dmarc.ietf.org>
Sent: Saturday, June 14, 2025 9:46 AM
To: httpapi@ietf.org <httpapi@ietf.org>
Subject: [httpapi] Re: RFC 9727 on api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs


Congratulations to Kevin and all involved in this RFC



From: rfc-editor@rfc-editor.org <rfc-editor@rfc-editor.org>
Date: Friday, June 13, 2025 at 5:18 PM
To: ietf-announce@ietf.org <ietf-announce@ietf.org>, rfc-dist@rfc-editor.org <rfc-dist@rfc-editor.org>
Cc: rfc-editor@rfc-editor.org <rfc-editor@rfc-editor.org>, drafts-update-ref@iana.org <drafts-update-ref@iana.org>, httpapi@ietf.org <httpapi@ietf.org>
Subject: [httpapi] RFC 9727 on api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs

!-------------------------------------------------------------------|
  This Message Is From an External Sender
  This message came from outside your organization.
|-------------------------------------------------------------------!

A new Request for Comments is now available in online RFC libraries.


        RFC 9727

        Title:      api-catalog: A Well-Known URI and
                    Link Relation to Help Discovery of APIs
        Author:     K. Smith
        Status:     Standards Track
        Stream:     IETF
        Date:       June 2025
        Mailbox:    kevin.smith@vodafone.com
        Pages:      17
        Updates/Obsoletes/SeeAlso:   None

        I-D Tag:    draft-ietf-httpapi-api-catalog-08.txt

        URL:        https://www.rfc-editor.org/info/rfc9727
        DOI:        10.17487/RFC9727

This document defines the "api-catalog" well-known URI and link
relation. It is intended to facilitate automated discovery and usage
of published Application Programming Interfaces (APIs). A request to
the api-catalog resource will return a document providing information
about, and links to, the Publisher's APIs.

…

v2.46.0 | Report a Bug | By Email | System Status