Re: Request for well-known URI: openapi

Anatoli Babenia <anatoli@rainforce.org> Wed, 10 July 2019 07:07 UTC

Return-Path: <anatoli@rainforce.org>
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 0F60F120103 for <wellknown-uri-review@ietfa.amsl.com>; Wed, 10 Jul 2019 00:07:04 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.604
X-Spam-Level:
X-Spam-Status: No, score=-0.604 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, PDS_NO_HELO_DNS=1.295, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=rainforce-org.20150623.gappssmtp.com
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 MmpVpewEKWwJ for <wellknown-uri-review@ietfa.amsl.com>; Wed, 10 Jul 2019 00:07:02 -0700 (PDT)
Received: from mail-ed1-x52f.google.com (mail-ed1-x52f.google.com [IPv6:2a00:1450:4864:20::52f]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 06290120100 for <wellknown-uri-review@ietf.org>; Wed, 10 Jul 2019 00:07:01 -0700 (PDT)
Received: by mail-ed1-x52f.google.com with SMTP id k8so1126104eds.7 for <wellknown-uri-review@ietf.org>; Wed, 10 Jul 2019 00:07:01 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rainforce-org.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=dJTw7pn3y7+XqMHGI6PnKjv0Kw7kO1qfCory5JYQ0R8=; b=aRPIP+mC7GqJmjJ2X4iquJtItnlPmin5ce0Q4on2nfbIoZZ+tpTWOzjmA+2nE77Z2g +JuNKHmiwcot6/kX1kicigMGHQ4jfjVtzLMu3BJIw8ViMDmmJK17Noc42PR9W9ZR7kMJ yOZTsl3270bK4oH2w+khh6yXrfsVCGx+NojY5ygO7OhUdxRpgGwrwYH/5FyhINAxpCAY tGvs1QaDz8NsxhEh+x7uVa0pL02jdPRL1Q5yq6uJGLPlCSmMg+KGv1AhXjKbVBgKIdtS K+dGNb9W640DKedCczzTUc7f7XV9k35dk2ixh/MyjmNx8xLORvLOtk9uLi8U/2OYwWsA dkhQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=dJTw7pn3y7+XqMHGI6PnKjv0Kw7kO1qfCory5JYQ0R8=; b=Dc4gl8zPStuRHOJyNeidjDFKGokKIEmsZu45D7D2UQZOjBrPXMp8TEK6Eu0TqKXKg3 gk3KyUFQRFdsNeIT5AAL64adgkdgOHeX37jx7Ism5OUHaATcOz2aDoqBccI5QuUZHgDG y3viW3LL1nvGtZiEuBy0gy0WOqX0lxRxl+lyO1wfjdD1myj6v0IjTni+trT2kzkw52AW MW95TRcwBBiAnzsiwF8CS2nHcXZ2rSrchqAkRfgCN36M/+hRS433N6XH2I0XwEfSTKLg +bH0zVir5xeyCPL7RAOaW3VDh9ze9PMUfTB86vYHO+RUJN27oiKlKV+nM+tbOc6i3l6M +MWQ==
X-Gm-Message-State: APjAAAVPyxulNgnD/Wb9WbU+iVycOTOg8d8ITT+ImR0pWXFPAyuCx7OV ECe+yFUATXrJBQ3vz2T/+QdshbbK9SxBAJMx/Ooqpw==
X-Google-Smtp-Source: APXvYqz/vUHOqScNub1f/vhOymKCrBNCcH8WV/eEhDsBnBZVweZsBJzO+qvAtLMNLptC1lwffChX+m2+Bu+YDZ7RdDM=
X-Received: by 2002:aa7:d1da:: with SMTP id g26mr29988401edp.198.1562742420421; Wed, 10 Jul 2019 00:07:00 -0700 (PDT)
MIME-Version: 1.0
References: <CAK=cShhYxOS=RORzQ8UzQ=RTitHFBf=pMxOdrV+Fk6-4qx_t7g@mail.gmail.com> <75853C6C-C26D-4D03-A842-AE350AB04453@mnot.net>
In-Reply-To: <75853C6C-C26D-4D03-A842-AE350AB04453@mnot.net>
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Wed, 10 Jul 2019 10:06:49 +0300
Message-ID: <CAK=cShgD72cueZEvimbMinAbC6LFUO1MnDydCKWAb4b4XVGjjA@mail.gmail.com>
Subject: Re: Request for well-known URI: openapi
To: Mark Nottingham <mnot@mnot.net>
Cc: wellknown-uri-review@ietf.org
Content-Type: text/plain; charset="UTF-8"
Archived-At: <https://mailarchive.ietf.org/arch/msg/wellknown-uri-review/sfqCRtKI7TezxAYsCn_U0ElHJ3U>
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 07:07:04 -0000

Hi Mark.

Unfortunately, the discovery mechanism is out of scope of OpenAPI specification.
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md

On Wed, 10 Jul 2019 at 09:36, Mark Nottingham <mnot@mnot.net>; wrote:
>
> 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/
>


-- 
Anatoli Babenia

+1 (650) 605-3365
+375 (29) 320-4241