[httpapi] OpenAPI media type

Darrel Miller <darrel@tavis.ca> Fri, 14 July 2023 02:49 UTC

Return-Path: <darrel@tavis.ca>
X-Original-To: httpapi@ietfa.amsl.com
Delivered-To: httpapi@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 1C58FC1519B7 for <httpapi@ietfa.amsl.com>; Thu, 13 Jul 2023 19:49:32 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 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_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=tavisdev.onmicrosoft.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id NUIT3mhUeSeq for <httpapi@ietfa.amsl.com>; Thu, 13 Jul 2023 19:49:31 -0700 (PDT)
Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2049.outbound.protection.outlook.com [40.107.220.49]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 64AE6C15199E for <httpapi@ietf.org>; Thu, 13 Jul 2023 19:49:31 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=k6kKLZIjhssP+wokYP4sa/WwdObiJIl51k/UQZZh8YwRxOjNa5ES9R+Wo0mNwIEL7dYRpQOgawddvWlknDPLjtyYfUqBn47x46nNKEs+NRqF2mBXX3LMn2n/4ApdxqV45ljSegFwxji9/UCW/qVrXhUQINXwW9EeKxYvSenn9i+LrJG5OXZHOxCty5cweuBSjA3zoZWTzAxrhZtSE7fpK2tX+yymP/cmH1k2uT3CxNqN2ds1l78tUlhmJjhFjX95gemOISeJ+dttKHT8xEaCCqeG8GMJ7zyXRKJnwsm5mLiNn1Q/NtXRuyoK5FbC0zHzSfYUnKfOEaOL4qJZlZHuHw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=lqbOYc1wofv0eBzbEJKBpRgT9KNOYWsh8jXoq+ufcxk=; b=HAznG6cDWx7l9w1VyjVh/jI6i0v3/vEXgDx861KwmeLrhV4TffE8RlIxAlw6aiYdBgpO6blPuPbq9Hbske4USfyeuDb87RaurOsAb7TAP+JBpDOhoLsf2ctxSA3pHbuIDRYZ8z7U8QQZRocbf2Re2K/nVFDUcdDJeqYiHKPA4G220XdPkb1y0ZUWozq7CHeqcNorkGDYzcIrm7sgW1r7lnU805GnKR3hZbnpAf1t3LkG8sZs0692r6Pz9E0b1r1gfhxsfARhZ3RItil427EPrT5bTPtJ/SI8nJ/jPPd+fEqVA8z71LAbtpGO+evJcsQjlt6vwrqQtmv/8rrr5xPrIA==
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=lqbOYc1wofv0eBzbEJKBpRgT9KNOYWsh8jXoq+ufcxk=; b=Ingn+xZe3KzmifRQCxMnGxnVXh2VYvGwjhzQ1Mw/bk1vUH3w2f1/4HMxODBtWrc/JmP1gBfmFT5T7RSUibNZCLaQo+KrpiQTOQVxB7722k8iIEWZDvrWS8D6p9s1gn4RuQAmg9CKET7VhzSRhaNv2BOSYj4yHvWo7jEZJerCbGc=
Received: from DM6PR01MB5964.prod.exchangelabs.com (2603:10b6:5:202::33) by CH3PR01MB8519.prod.exchangelabs.com (2603:10b6:610:1a0::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.32; Fri, 14 Jul 2023 02:49:27 +0000
Received: from DM6PR01MB5964.prod.exchangelabs.com ([fe80::83b6:51cb:2ad:b5c4]) by DM6PR01MB5964.prod.exchangelabs.com ([fe80::83b6:51cb:2ad:b5c4%7]) with mapi id 15.20.6588.024; Fri, 14 Jul 2023 02:49:23 +0000
From: Darrel Miller <darrel@tavis.ca>
To: Roberto Polli <robipolli@gmail.com>, "rsalz@akamai.com" <rsalz@akamai.com>, "httpapi@ietf.org" <httpapi@ietf.org>
Thread-Topic: OpenAPI media type
Thread-Index: AQHZtflLJEDVzUf87Ee51C6TJVoo1w==
Date: Fri, 14 Jul 2023 02:49:23 +0000
Message-ID: <DM6PR01MB59649684F8CC6F6432D6990EA334A@DM6PR01MB5964.prod.exchangelabs.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: DM6PR01MB5964:EE_|CH3PR01MB8519:EE_
x-ms-office365-filtering-correlation-id: c2521815-4a46-4b62-7e10-08db8414ee53
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: QxT2NBo6jGAJWJFrYvSPXtFn5KzHr7pvbNuJHsdORHglc4jy+vxPnx/94/+5at1XijH1kYvJJ+RhQG73y1vmZIGKteFkPnqQUyFKKVhCKSyW/U/ufLcP4p0yR8zqGW0jREFdngBotF7rI8+5U98QW+IFGem3xrLCq9qpQFm/Rg+PPIcUjCCOiR+aleKFDvId78ksh9S+PF8o8XqjUvTzgG543N6LoHNopXjJpWwlVdsO9AcnMisV1XQ3UjRUFDiE4XAeVV0cBr3669U/tv4iyD8ULO+R9q2lt8lzQBbEOpCtWdANOOcPrsbwSbcriJ0BB/VU01WouWiGl4JjV06I+vVzDnq3i7BHNLy2CSF1Uzc0HxGqClBC9poeauneC4Hxm1wMjphl+E4qywyxrBepuJGJaByd/PfNThoRODJkLhDe0O2gCaTEPxTCN4RH2PjqrezJHoA8bgsMHaEI8v2vKo6jDQ4hyhDc9WqXMQaU7zdCdL4Bzwx41PIgrBeg0+xCtTuhoI5G/YAn4ywmt9E1J3SE9kWFmd/Z7IycInP4+DENtV0e43xVFioonzp9jeA9+FnsGv4inCvWsF5VGijDBwVClD4ETGDSnrFjuhMTp3U6aHtuhYzQ2MOECsuHLCJ0
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR01MB5964.prod.exchangelabs.com; PTR:; CAT:NONE; SFS:(13230028)(376002)(346002)(366004)(396003)(39830400003)(136003)(451199021)(9686003)(316002)(19627405001)(41300700001)(8676002)(66446008)(7696005)(66946007)(66476007)(66556008)(76116006)(64756008)(110136005)(83380400001)(478600001)(6506007)(3480700007)(71200400001)(91956017)(38100700002)(122000001)(33656002)(38070700005)(8936002)(86362001)(55016003)(26005)(7116003)(52536014)(5660300002)(2906002)(4744005)(186003); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: FmGisuX/SnEbu8VCftleCpYl0doRx7nGl722AIlGnMDb9XWYNZWO8eRpnszWJ3tken6DUVkSPT4J/WyjFA0D6AEHaxWD2iwFbLJq1Oioy4CXvPjqQcLOsD9vaCVyGpOSM12gX6wq6heOu4mwtaDL688hFBsDAvdKbqP3KmhbXU7b5+eExSkqydG02rmtKOQYiXuPoD8Ce6sxqUEuism/bKWoSkTNqwaP+4KePu1k4dmperGzCz81yYMm62J7/PE1p5NFxiUP5cp3gcEz4LHVsaTY553UCAPdxnQ+PJHSY98MWX7vL+ptN7fnrRGl95IR5m5Qq+GlaAMdLekwAHQcX64mCFew/mcgRgUeCiV7Ax+RcGqMowQpDBd7nSwVeF2QlTgeko9A9Cazw58epQIsYALnZ+b1zh9aV3BvXX4DUZWXJR61jh4JU4l6611u1oRapSq3WsZGrNh1WaO9Xdji21KtrUHGFjfRij3uuIAfocAxe/SJbp3Va90sVMmBfT9Na0KJ5tNopGGQAdxfCwAFNFiPuHjAkBweDVBEJfOvtJizYNEbmUBfaJk/tIJmG4I2rO4VcQiDWORNvhj1s2EWAlIX+WtpwlXVH4UBe/pUStryIBPxugrZXunW2e9Sikdilk9vQBi3OepY+Hte+33KJBG32OUkplD/hC50RvKOOdtTrKOz5+3kOXQzVmS69pratWUmC6OvFqGE5lw+AcUAjMlkUauEsESMwuj3klAxPIfAKJFlrXoBGpg5rxU5OrjRT0xW6gJeQ9O01l3ffW/KrGvkz3QI2fnn6apqT4GqZdRzMOGuPkul23ejdcceSVdEM9F0IS/4ske8NbZtWH1wa1CzSeZgSBGBAM7Nnoi9GnsnqksBEWmuJZMJOaY5koKdS3k2N65Ao/o7IDCv2funqrawZYiqxKDF/lnDLUNO/+1SMdamXJEevJAVMnS0XubyIcZ/pMPQXbtIRJhYBsNtb3K3I6XAGuvsNTypiG5PnLumE0PozFwWirr6CJLBHowm/OFbq7P//cDf44ZeaucrIqIA6yMeQPuVjzXUA3pMlQD9gJ858IQIhNvThSSnEAbqAd74ocA0HRJYDu4c6HL9/yjHA9EkTKsWYeGpnSDWuRvHuKHiRbsLtvzz/DZKvAa4zZiOM2+XsOSruSo11RB7uLOC2qzkGo8/Yi2f2aTx+56sjTTN3tDR4fuwelGBrxyh6vfjCBf3inXSdfiY7bBRgVxf6QXs9iHnB9MUBffynieenqim+48PMMlnISWHu4pVvWRFVOEQfJ5T+DCvyQ/ezR5BiXXuzOZhVxXL/Vh+/fU/5u9XP4/QnnG99UIMHtuacfy5qhZfubJOmAf5Jr4nFH8rOJvWm47sJScpC4DBKhU/MMAiBx7jvqTvOI9QQUdjiuhqsTe6zPcaPUj6XOkOz/6aILVXY5ICYUOIbHfLl23cXzfjTeOwoBD3GJmrzqPVIsgvYLSRB6EzyNQzskK+QFb/3XXyY1y8dMM3rWs8J7xzzgdi8asZ12L+g+U0zbUPugvHRveYXvuxIF9974c/l4QjIFzb/O4UKx4QbVvkFC0=
Content-Type: multipart/alternative; boundary="_000_DM6PR01MB59649684F8CC6F6432D6990EA334ADM6PR01MB5964prod_"
MIME-Version: 1.0
X-OriginatorOrg: tavis.ca
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DM6PR01MB5964.prod.exchangelabs.com
X-MS-Exchange-CrossTenant-Network-Message-Id: c2521815-4a46-4b62-7e10-08db8414ee53
X-MS-Exchange-CrossTenant-originalarrivaltime: 14 Jul 2023 02:49:23.5333 (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: 4SVMCfU5hNfuNc1nZK3nac0wboUrS1WT91HbvZxxGWdQnQiWe3f4IRBZbXn+Lp9D
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH3PR01MB8519
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/brnlwpV8J5kBCNBfxrno1KNWjQs>
Subject: [httpapi] OpenAPI media type
X-BeenThere: httpapi@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/httpapi>, <mailto:httpapi-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi/>
List-Post: <mailto:httpapi@ietf.org>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/httpapi>, <mailto:httpapi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Jul 2023 02:49:32 -0000

Hey Roberto,

Now that the YAML media type is in the queue for publishing, I am wondering about next steps for the REST media types.  I get the impression that there are still some challenges to resolve for the JSON Schema media type.  How would you feel if we were to split the OpenAPI media type registration from the JSON Schema?  I believe the only open issue for OpenAPI is the missing security considerations.

Do you think that it would be worth splitting so that we can move forward with the OpenAPI media type?

Darrel