IETF Logo Mail Archive

[T2TRG] OpenAPI/AsyncAPI discussion from April 24th WISHI online meeting

Jonathan Beri <jmberi@gmail.com> Mon, 27 April 2020 00:07 UTC

Return-Path: <jmberi@gmail.com>
X-Original-To: t2trg@ietfa.amsl.com
Delivered-To: t2trg@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B1F293A03EF for <t2trg@ietfa.amsl.com>; Sun, 26 Apr 2020 17:07:38 -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, SPF_HELO_NONE=0.001, 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=gmail.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 jrdwZC7xhYXP for <t2trg@ietfa.amsl.com>; Sun, 26 Apr 2020 17:07:37 -0700 (PDT)
Received: from mail-ua1-x92c.google.com (mail-ua1-x92c.google.com [IPv6:2607:f8b0:4864:20::92c]) (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 1EB253A03ED for <t2trg@irtf.org>; Sun, 26 Apr 2020 17:07:37 -0700 (PDT)
Received: by mail-ua1-x92c.google.com with SMTP id b6so1860492uak.6 for <t2trg@irtf.org>; Sun, 26 Apr 2020 17:07:37 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=KyX+9iJilGeH6Yuy2ccotch0IkhR/TIMQw8AS/6IC+g=; b=BB4Mnqg6nayxMU3fT1ZXWtcKp9kPSUFea4K6amPEFqfiKOjm/ie+ZQogvjGXI4sXTJ zMNjKrI2V+omt3ImnZ38CgCuCHaLlnogtNsRBRiG81IeF04WPnH/pgmzAdZ4VLEARNsA Tep2xAbWbW/M+nzKKTH0lETtGjadLHX1qsQHfdQXM4SiTj8MZ+FumfsJlu2KPGEqC8Um ki5uNQBQUlyFQUn+ZYPRMbnXSyJo7wQh2RJNGVpca+H1FnFM83oQw7EDyovaXhJLmfN1 PbosbLXR9zpKkKzxyZND2Dctwri4of15jBlTUzGAWt5Li+Bs0nKwc/xMW2qqS7ZLY3lo j1tg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=KyX+9iJilGeH6Yuy2ccotch0IkhR/TIMQw8AS/6IC+g=; b=b/aDkeK/1ZWpnmmPGGzcCiTKWeLEOYAuuZPSk8/1fbnd0LkBaE2C+jmJF186xqmNsy 1gBbO9JqZuBi4yZ5UDAlHiiWD62tMtaIjrvSYafVFkRuPcLTJ2EkV22sNpsGviNcvIxE c320jZZ2wHg8IIe9YRKEG5NxUC+6xdCCBZMy3uT5aRir71hF8KXphLjIJEdw27FamMwH sivn7Df8Cch8N8OehLvxfyiTNvi13TviFjoe8LBFFFkBP4tAK58BXerrVq+ULXit2j0g TtnV1EqWxuEZVRuIb1d97zFxICMrBUfugeEQPFu8j381aLp2ShRpqgNYjqshrss4Cf8B IHeA==
X-Gm-Message-State: AGi0PuZBX/s7AgOddhQOPO9x1kY4kTOkt5q/cDOeH8MAwhgh4DF0q/vZ tLBSwdMA342qpi49jf9glfTajMtCdRuJha/j7KPZvc+xe0u/cA==
X-Google-Smtp-Source: APiQypKkEDlGOvyu7csmYT5Jc3eOOsoQFeW8MVL3zNJo6BEL+jMml6/L8o6Lzz1E40ubN9CY1CJbGH0vJHpr2JqU/UU=
X-Received: by 2002:a67:7c50:: with SMTP id x77mr15276000vsc.187.1587946055580; Sun, 26 Apr 2020 17:07:35 -0700 (PDT)
MIME-Version: 1.0
From: Jonathan Beri <jmberi@gmail.com>
Date: Sun, 26 Apr 2020 17:06:58 -0700
Message-ID: <CANcmUPGaobBb0kXbUeTkXm7WGqB4gXuC08kdmFmhcSNv_bTRHA@mail.gmail.com>
To: t2trg@irtf.org
Content-Type: multipart/alternative; boundary="00000000000090c27205a43a80c4"
Archived-At: <https://mailarchive.ietf.org/arch/msg/t2trg/Gkgfxy8UcUVLDWNnrFg32h1NYc8>
Subject: [T2TRG] OpenAPI/AsyncAPI discussion from April 24th WISHI online meeting
X-BeenThere: t2trg@irtf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IRTF Thing-to-Thing Research Group <t2trg.irtf.org>
List-Unsubscribe: <https://www.irtf.org/mailman/options/t2trg>, <mailto:t2trg-request@irtf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/t2trg/>
List-Post: <mailto:t2trg@irtf.org>
List-Help: <mailto:t2trg-request@irtf.org?subject=help>
List-Subscribe: <https://www.irtf.org/mailman/listinfo/t2trg>, <mailto:t2trg-request@irtf.org?subject=subscribe>
X-List-Received-Date: Mon, 27 Apr 2020 00:07:39 -0000

During the last WISHI meeting I brought up interest in exploring the
adaptation of API specifications OpenAPI (openapis.org) and AsyncAPI (
asyncapi.com) to CoAP. The discussion starts at line 164 of the notes (
https://hackmd.io/lY_ktzBjTuSu_5oh3u20Bg?both.)

Michael K. & Michael M. suggested a few action items:

   - Create an example Thing Description and see how semantics map to
   OpenAPI/Async
   - Identify use cases for developers in WoT, such as Node-Red
   - Document scope and overlap between different specs

A few follow-ups from me:

   - Are others who weren't on the call interested in collaborating on this
   topic?
   - What should be next steps? Should we target an upcoming meeting?

Many thanks.

-- 
Jonathan Beri
linkedin.com/in/jonathanberi <https://www.linkedin.com/in/jonathanberi/>

v2.23.0 | Report a Bug | By Email