Re: Request for well-known URI: openapi

Mark Nottingham <mnot@mnot.net> Wed, 10 July 2019 06:36 UTC

Return-Path: <mnot@mnot.net>
X-Original-To: wellknown-uri-review@ietfa.amsl.com
Delivered-To: wellknown-uri-review@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0871A120103 for <wellknown-uri-review@ietfa.amsl.com>; Tue, 9 Jul 2019 23:36:13 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.7
X-Spam-Level:
X-Spam-Status: No, score=-2.7 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mnot.net header.b=Dz9yMD2S; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=UEtFkzzV
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id qXu3RywYEpEX for <wellknown-uri-review@ietfa.amsl.com>; Tue, 9 Jul 2019 23:36:09 -0700 (PDT)
Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8BD87120299 for <wellknown-uri-review@ietf.org>; Tue, 9 Jul 2019 23:36:07 -0700 (PDT)
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 3830D22106; Wed, 10 Jul 2019 02:36:06 -0400 (EDT)
Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Wed, 10 Jul 2019 02:36:06 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mnot.net; h= content-type:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; s=fm3; bh=j wKYMsRh78G3nIEg8bf/0uBjVA5AYmmxWECVz9ca2F0=; b=Dz9yMD2SL/MVP++i0 kxkbsNn86fLzMfhY66MzzZt8IPCb0mKmHf/U+qFipBxapsbaqYa/V38PnNrB6iWR UL0BEK2TB+cXQd/1CKgu+rUnmSCgqOkeJAkzY3aSi2WyMyckjyXYGFvUasXWE8Dx +ZtEZGTflYUhwJYJDRPo9q3pvJzZlpKg8By/GYcSu07HVkG8jEkoG1rUPzxf1FB5 qOHtPc+kuG9eXOyxWzKve6bQkRSr9yDxIw1aMZwqu0JuyvukRPDt7ZnNAYpiwKdi MDcC48ESYEZQmZjwz5ArR+LrbsAhUbMpozu0JMmCvOx4JRFsT0lXxTYM7UftUcXa WIlCQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=jwKYMsRh78G3nIEg8bf/0uBjVA5AYmmxWECVz9ca2 F0=; b=UEtFkzzV0J+6pykvdQRougPvOn+PpkFShnncWBMyh3dZx6QFhzB8O/raW j8qJS3T/wK4HNy9wwyFBeLrV51s7NqMo/iQICGDmJgvvGh5ZRx2YDltVdmlGEkaC MQDTOgIJYXyFy8tiyUsVDabPMMr3nCg3cHHPml20ZXZdrm1QZbRfmz41DpOvDIvo M6f61lKuikhrMab1eCEGmhRXNCDahcX7eIKaK5WTXiA035eHPRMEa/Egc2FRGkw5 eG41kOI3fzIOKyQypqAGu3UltmV5XKe1RCF72OjutLdoYS6y+mGj6RMMxwohzu7f wOak/rZp2bVVTGvKDj9lfazBNOnDg==
X-ME-Sender: <xms:VYclXYyDZCe3agN1TKdP2LFRf_nlC12H1sb3k3qGy2C-XU7VH7BaUQ>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddrgeehgdehiecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpegtggfuhfgjfffgkfhfvffosehtqhhmtdhhtddvnecuhfhrohhmpeforghrkhcu pfhothhtihhnghhhrghmuceomhhnohhtsehmnhhothdrnhgvtheqnecuffhomhgrihhnpe ifihhkihhpvgguihgrrdhorhhgpdhgihhthhhusgdrtghomhdpihgvthhfrdhorhhgpdhm nhhothdrnhgvthdpvgigrghmphhlvgdrtghomhenucfkphepudeggedrudefiedrudejhe drvdeknecurfgrrhgrmhepmhgrihhlfhhrohhmpehmnhhothesmhhnohhtrdhnvghtnecu vehluhhsthgvrhfuihiivgeptd
X-ME-Proxy: <xmx:VYclXZ-xH8reLIWcbm6_JmEXPtpl0XB1LOlckKRGsQJ-h2OY55ZUcw> <xmx:VYclXcFkGn3D4G5-zppIWes5ksPzevQff1XAgq1hK5UwXsGbVZxIKg> <xmx:VYclXTAFGrYe91LAW74G6qN3XbYAildBVoUorSdoZ94l8wCNCJbPKg> <xmx:VoclXQJV1y_NLUquEDu29VXIdNN38xgkDTEMLry8ckz4YPPGtTMBpQ>
Received: from macbook-pro.mnot.net (unknown [144.136.175.28]) by mail.messagingengine.com (Postfix) with ESMTPA id 3A23C80063; Wed, 10 Jul 2019 02:36:03 -0400 (EDT)
Content-Type: text/plain; charset="us-ascii"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\))
Subject: Re: Request for well-known URI: openapi
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <CAK=cShhYxOS=RORzQ8UzQ=RTitHFBf=pMxOdrV+Fk6-4qx_t7g@mail.gmail.com>
Date: Wed, 10 Jul 2019 16:36:01 +1000
Cc: wellknown-uri-review@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <75853C6C-C26D-4D03-A842-AE350AB04453@mnot.net>
References: <CAK=cShhYxOS=RORzQ8UzQ=RTitHFBf=pMxOdrV+Fk6-4qx_t7g@mail.gmail.com>
To: Anatoli Babenia <anatoli@rainforce.org>
X-Mailer: Apple Mail (2.3445.104.11)
Archived-At: <https://mailarchive.ietf.org/arch/msg/wellknown-uri-review/PmW47q-_NmS6wN541DXhF3wOD4k>
X-BeenThere: wellknown-uri-review@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Well-Known URI review list <wellknown-uri-review.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/wellknown-uri-review>, <mailto:wellknown-uri-review-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wellknown-uri-review/>
List-Post: <mailto:wellknown-uri-review@ietf.org>
List-Help: <mailto:wellknown-uri-review-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/wellknown-uri-review>, <mailto:wellknown-uri-review-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 10 Jul 2019 06:36:13 -0000

Hi Anatoli,

The "specification document" field needs to point to a stable specification; here, part of the OpenAPI specification, presumably.

Cheers,


> On 10 Jul 2019, at 4:21 pm, Anatoli Babenia <anatoli@rainforce.org> wrote:
> 
>   URI suffix:  openapi
> 
>   Change controller:  anatoli@rainforce.org,
> https://github.com/yakshaveinc/tasks/issues/48
> 
>   Specification document(s):  The field returns URL to OpenAPI
> specification. For example, http://example.com/.well-known/openapi
> could return https://api.example.com/v2/openapi.json
> 
>   Related information:  https://en.wikipedia.org/wiki/OpenAPI_Specification
> 
> -- 
> Anatoli Babenia
> 
> +1 (650) 605-3365
> +375 (29) 320-4241
> 
> _______________________________________________
> wellknown-uri-review mailing list
> wellknown-uri-review@ietf.org
> https://www.ietf.org/mailman/listinfo/wellknown-uri-review

--
Mark Nottingham   https://www.mnot.net/