Re: [httpapi] OpenAPI media type

Roberto Polli <robipolli@gmail.com> Fri, 14 July 2023 07:41 UTC

Return-Path: <robipolli@gmail.com>
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 93C91C15C513 for <httpapi@ietfa.amsl.com>; Fri, 14 Jul 2023 00:41:06 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.097
X-Spam-Level:
X-Spam-Status: No, score=-2.097 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 R2nE6bc9m0p4 for <httpapi@ietfa.amsl.com>; Fri, 14 Jul 2023 00:41:04 -0700 (PDT)
Received: from mail-lj1-x229.google.com (mail-lj1-x229.google.com [IPv6:2a00:1450:4864:20::229]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 7DE0AC15C510 for <httpapi@ietf.org>; Fri, 14 Jul 2023 00:41:04 -0700 (PDT)
Received: by mail-lj1-x229.google.com with SMTP id 38308e7fff4ca-2b73564e98dso24020641fa.3 for <httpapi@ietf.org>; Fri, 14 Jul 2023 00:41:04 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1689320463; x=1691912463; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=yOCN+cnI5RmsQuOlj/U8Hk6Fl65YhNh1CGRndceWuI8=; b=mkfKe6y1MvIhIAVE2LjG6VGKYjrSGvbURnvJri/daYW3dwLd0HUy0q5vHmc9uooPcE wwBLgrJqu6fnRmeeY58mj96m8n/NXLCTeSQLJB8QSYh0PKBHEwZb6HZe7EIFZ/t+/ICF /JEbbFPOFA5rkCc58rnrtjXG3uQXtEAxA9J+8T/9t+S2NnO+eoZBk9T+f+sGxq/OkHS7 fV+STovAN7qOUYzxdb6KseFngOFsxzBQHZKaZ3i/OwaR3vwUpg2Vh9i3gnRkxSmndAGU MxZvIhOUkDhN1d9jGeGztM5tsJ6p1hEjZuU8rrGNvavoy+y+KaaMZ8lBuG/tbdGzRq/n uy/g==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689320463; x=1691912463; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=yOCN+cnI5RmsQuOlj/U8Hk6Fl65YhNh1CGRndceWuI8=; b=bujJQnh7lxCDy/t+z3GmPMv5hrjZgrntLB3PlJFzGZB1vLzwHLH30kOsy8TgYsHbz5 CQZeA2nfHIE1eVe5NH4takNEUdVmGfLSt9OdEqum95CQZUGZaF6xklnOIJrWCL7/EpCv epAwqhCDUTmrognwj7lAGBodNcnWOgg+dZTXi6jQVCsy7LRHhg39eamDxqzB8C4uNeW7 Z4DJ67APAHSstY4onf1W3YrIqygmDqumGy9qsOT0mYVUDCsJmwFFTL/Id9f7WUXA0mHC 7nFq9i8pNWYWZKuLQdRbFota21vV0tgOtKa59WLC3rngRjCXJ01LH3aizD9fuigWFCyM Kcpw==
X-Gm-Message-State: ABy/qLaXiwDMsV8tj9kgnUKXL7qv66HKoy+QAOGRPMSF76cYwEWppIhR a/VdVP14n8ReXXluEnlcq5nNtLpE62GjwD0SG4o=
X-Google-Smtp-Source: APBJJlGLSuECMNYNSSF0V7wXPoKtoA4d8Sa4QQEpf18WxTYNnkoTvWUursx4Z99s7ikQCK2F2WLYgJv20b7u11MLJMc=
X-Received: by 2002:a2e:9a99:0:b0:2b6:a05a:c5c with SMTP id p25-20020a2e9a99000000b002b6a05a0c5cmr3290013lji.1.1689320462390; Fri, 14 Jul 2023 00:41:02 -0700 (PDT)
MIME-Version: 1.0
References: <DM6PR01MB59649684F8CC6F6432D6990EA334A@DM6PR01MB5964.prod.exchangelabs.com>
In-Reply-To: <DM6PR01MB59649684F8CC6F6432D6990EA334A@DM6PR01MB5964.prod.exchangelabs.com>
From: Roberto Polli <robipolli@gmail.com>
Date: Fri, 14 Jul 2023 09:40:50 +0200
Message-ID: <CAP9qbHWS7+zMc9XkjnduDoR6FBAXgLqw0dMWdraW2t66=Kk0ZQ@mail.gmail.com>
To: Darrel Miller <darrel@tavis.ca>
Cc: "Salz, Rich" <rsalz@akamai.com>, "httpapi@ietf.org" <httpapi@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000012994b06006d923f"
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/FEGdfXOkABP4HWzoKL38LxOsPn4>
Subject: Re: [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 07:41:06 -0000

Hi Darrel,




Il ven 14 lug 2023, 04:49 Darrel Miller <darrel@tavis.ca> ha scritto:

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.
>

That depends on our objectives. If we just want to register a label, I
think that's ok.

If we want to ensure the interoperability of all the stack, including the
relationship with JSON Schema, I think we need some more discussion.

My 2c,
R


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