IETF Logo Mail Archive

Re: [dispatch] Building Blocks for HTTP APIs - next steps

Darrel Miller <Darrel.Miller@microsoft.com> Sun, 02 August 2020 03:18 UTC

Return-Path: <Darrel.Miller@microsoft.com>
X-Original-To: dispatch@ietfa.amsl.com
Delivered-To: dispatch@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4394C3A0B5F for <dispatch@ietfa.amsl.com>; Sat, 1 Aug 2020 20:18:32 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.1
X-Spam-Level:
X-Spam-Status: No, score=-0.1 tagged_above=-999 required=5 tests=[DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=microsoft.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 z8hRA4GGJJmy for <dispatch@ietfa.amsl.com>; Sat, 1 Aug 2020 20:18:29 -0700 (PDT)
Received: from NAM06-BL2-obe.outbound.protection.outlook.com (mail-eopbgr650133.outbound.protection.outlook.com [40.107.65.133]) (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 5596A3A0B6F for <dispatch@ietf.org>; Sat, 1 Aug 2020 20:18:29 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=R1JBbz1sTyiBKBi/FBk2/w2fJ+cYg/3JNHPEk0fm+D/4kIeEGIMARRGVzP3yg5IZ1w23zxCZF/K/FU6YSEZIzz2ScNijtN5ZImNS6qfC1bhDIolyBzpSIiXRh+Sk8/i4yPxNCUR4mzv092BssB6jaaNzKkCSpEzaoJmfgHLzN3L3V/d0vw5ahu/9h5FiH7YziCoDg0oorJGisqzqjQjWNbC7/Ro9m4j/2wqy0sOXkx7K9fUojkGJ5cRFyDOQrsjIPUJXMI4rqO5RJd8lJ+JLpQKI+YmKt+Duq/2LKAkeguAyv65RVx33tnKiEceyhf4JbcOsTzqnyJLahvl+xapweg==
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-SenderADCheck; bh=ocRX/KGunbC9vHdv3oWeZr/7dPbVOJlSkhKBJl1iVeg=; b=Ka1QDFBGWcV7ap5WCdlFV/iqwKYa/cnmg6E3T6EQ6Krga7ITB/faUSjur+u7sYpJefglqfVDha0clAVc9f2LEp+w0OWXyduyVZB33eA8hDjpKioopr/ctMWz/pZOT/tSIUcnWpAVNAlkhGqyGUgwzNF/8C3Z/vpG5Q/BYk6bCjeT913mPgWWFYHR/jkeyaY9Bitt8EnRa2+ym2hWA5MqUXlfybvXd9YRlRW1FmXzsRbwI2U1nX4zKNGX1Je5ceP6sdzOFCv5XMhvOQkMYpXJN5+Zo9J8AMPbZ4rHIpb23VZ2KM6QhGHJw2go6nlFB0tO4EniTNt+t05hoiGwqh04Ow==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=microsoft.com; dmarc=pass action=none header.from=microsoft.com; dkim=pass header.d=microsoft.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ocRX/KGunbC9vHdv3oWeZr/7dPbVOJlSkhKBJl1iVeg=; b=ZI8o+vEL0xkjKGvx0EaBEe4nc/biSM3ixPjpxycFyByWzqlzOMV9CCnmoftKX+N0l1zBJgH4y4Z4vTQMl0S2PdIGo848pf/11sBa6N9mK3w/Rm3ZmK3B+TSyJYRDpkVa2AzTfcGXzRgVVNScSIbWFFacIyA8GiszOMMa2mfxlSw=
Received: from CH2PR00MB0844.namprd00.prod.outlook.com (2603:10b6:610:6f::23) by CH2PR00MB0679.namprd00.prod.outlook.com (2603:10b6:610:af::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3291.0; Sun, 2 Aug 2020 03:18:26 +0000
Received: from CH2PR00MB0844.namprd00.prod.outlook.com ([fe80::d4ca:3e4:4c23:3aea]) by CH2PR00MB0844.namprd00.prod.outlook.com ([fe80::d4ca:3e4:4c23:3aea%7]) with mapi id 15.20.3292.000; Sun, 2 Aug 2020 03:18:26 +0000
From: Darrel Miller <Darrel.Miller@microsoft.com>
To: Rob Sayre <sayrer@gmail.com>, Mark Nottingham <mnot@mnot.net>
CC: DISPATCH WG <dispatch@ietf.org>
Thread-Topic: [dispatch] Building Blocks for HTTP APIs - next steps
Thread-Index: AQHWZzKma9xoffc2Rk6RrnEK27+sSqkiZESAgAHACHY=
Date: Sun, 02 Aug 2020 03:18:26 +0000
Message-ID: <CH2PR00MB084497EEB38BC0EFED683165F04C0@CH2PR00MB0844.namprd00.prod.outlook.com>
References: <FED20ECD-A850-407E-B0DE-59A43B8D318E@mnot.net>, <CAChr6SxUj07PRfKVi6V7APFGyh3Hv9ifRuXbYba8N8KzX1iv6Q@mail.gmail.com>
In-Reply-To: <CAChr6SxUj07PRfKVi6V7APFGyh3Hv9ifRuXbYba8N8KzX1iv6Q@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-CA
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
msip_labels: MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Enabled=True; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_SiteId=72f988bf-86f1-41af-91ab-2d7cd011db47; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_SetDate=2020-08-02T03:02:24.7542040Z; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_ContentBits=0; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Method=Privileged
authentication-results: gmail.com; dkim=none (message not signed) header.d=none;gmail.com; dmarc=none action=none header.from=microsoft.com;
x-originating-ip: [69.159.101.65]
x-ms-publictraffictype: Email
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: edd2a428-e52d-4fdd-9069-08d83692b8a8
x-ms-traffictypediagnostic: CH2PR00MB0679:
x-microsoft-antispam-prvs: <CH2PR00MB0679C5C9C002AF2309815F9BF04C1@CH2PR00MB0679.namprd00.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:8882;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: IyJiOULY80hOPRZd+Mx4GYqQlA313YFLTQJ1iunCc79YVhQ8zGKaVTSnY4SDXDtwqvLpHdcZvADWJHU1GxuVYTYMep0VnTwtqKLemC6WYkpyIBsQFsW9tplanfmi0W2NrlSoasVLwzFcUmSLqoEZpbp9gLX+2nx9LTv3ShYBCtSImTve92UdLLZwEojWT00SUkx6w+ONdDL9/1d6DDbSAGU/O2T5EmwN2gJ6bAylv7o3TLZdpjAb+xifb0dFpnUlADj4kbUNsaQhhmWZoqRcUVkjxE2tCKOUbKZ2G9wlAW8F46FOwV1JOhLyJrFafLj6RrEu9P3pY+i62MFBOBWPTNrbWCoGQpKe5R2zsJiyk4I6eA7PlKWTkCL5IZb+mL8mWVcQ4Rrl76VHOX84wjHwbA==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CH2PR00MB0844.namprd00.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(376002)(396003)(366004)(136003)(346002)(39860400002)(2906002)(166002)(8676002)(71200400001)(186003)(33656002)(966005)(478600001)(7696005)(82950400001)(83380400001)(82960400001)(86362001)(110136005)(316002)(5660300002)(66476007)(66556008)(66446008)(64756008)(8936002)(26005)(8990500004)(55016002)(53546011)(6506007)(9326002)(4326008)(52536014)(91956017)(10290500003)(66946007)(76116006)(9686003); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata: +fzdBxq5tz84zRy/C0zdWPNuvsat2c3Zy3PYMaJDULNi2HnXsjtc0iUPExim0tIe43X1JnyetM5meADbfdCG6rBNTDjm/WQNqlzAe01sWi9nf9f7Ub4gv2VcP4Mnt7zaU4Qmd8EqEKRftpibjyLuI5zbiDgwlJRdtE116TLpb3JZfVXA2X8w0ZE2gqKGavNHXaJI3zkZvY3RQ73r7MHo8d6v/iPMKD5SNn35Ab6gMeEQAgZmRc74QgBbKFVA1Ju6ohB+4yU+rbhIfPZgq/UTKVXQkucwbCNob6VIlGpvXKnIXZkugtnBPc5+7NM9AmD/O6R4NwYDPn9yuY/PLf6py0HfCBSdVC5s2FkNEvezjDgSo6WXrhTqpPtglwEI/CAyt3aGUC+VX0BuGTarokgoFFBeE/FuqVivMWOomCZTPjRnICylUsVFebgFO1TwWD7l/v9fC7siXfZcxJGAPc+vnTQQwmXxh0hoGk67OHLmeldMBFl8iGqeR9U/Oj4+urBn9gaEFY8dALV/FqJt6I9gMjLJRb0JJhk1+NDSBqqfo847E67aw/8DLR3tJAFQYynBYcZOs7i7k+KY+L7fO3APnssgDrpEiiQgy19ndXzaeAk4T6nuKMUoT7T8uDx+V4fRn/ScL15jcNdR+qHDuTTkzA==
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_CH2PR00MB084497EEB38BC0EFED683165F04C0CH2PR00MB0844namp_"
MIME-Version: 1.0
X-OriginatorOrg: microsoft.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: CH2PR00MB0844.namprd00.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: edd2a428-e52d-4fdd-9069-08d83692b8a8
X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Aug 2020 03:18:26.2213 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 72f988bf-86f1-41af-91ab-2d7cd011db47
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: ZztV7ZkIsLs7Ks+ierkdWLG6WGyYczmLBsFg4GttXog6A8s+wZXBHPoNTLQsmdm2rHunBjpjWDXzzh9NtNzhlg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR00MB0679
Archived-At: <https://mailarchive.ietf.org/arch/msg/dispatch/UzxRqmFffKPu-jvolLbbXvUHKb8>
Subject: Re: [dispatch] Building Blocks for HTTP APIs - next steps
X-BeenThere: dispatch@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DISPATCH Working Group Mail List <dispatch.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/dispatch>, <mailto:dispatch-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/dispatch/>
List-Post: <mailto:dispatch@ietf.org>
List-Help: <mailto:dispatch-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/dispatch>, <mailto:dispatch-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 02 Aug 2020 03:18:32 -0000

Hi Rob,

There is a sub group within the Linux Foundation GraphQL project that is focused on creating a specification of how GraphQL should be layered on HTTP. https://github.com/graphql/graphql-over-http/blob/master/spec/GraphQLOverHTTP.md

I think the HTTP API Working group could co-ordinate with that group to identify any gaps in HTTP conventions/patterns or guidance that would help with GraphQL layering over HTTP.

>From the perspective of HTTP, GraphQL is media type for the query and one for the schema.  The response is application/json.  GraphQL could definitely make use of the SEARCH method.

I see efforts such as GraphQL, JSON API, OpenAPI, RAML, OData as being “customers” of the work of the HTTP API working group.  I don’t know if the charter needs to reflect that.

Darrel



From: Rob Sayre<mailto:sayrer@gmail.com>
Sent: July 31, 2020 8:19 PM
To: Mark Nottingham<mailto:mnot@mnot.net>
Cc: DISPATCH WG<mailto:dispatch@ietf.org>
Subject: Re: [dispatch] Building Blocks for HTTP APIs - next steps

On Fri, Jul 31, 2020 at 5:03 AM Mark Nottingham <mnot@mnot.net<mailto:mnot@mnot.net>> wrote:
Hi everyone,

After some tweaks resulting from the meeting discussion, I think this charter proposal is ready to go to the ADs. Any last comments?

It might be good to address the value this effort will add in addition to things like GraphQL:

https://thenewstack.io/graphql-gets-its-own-foundation/<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fthenewstack.io%2Fgraphql-gets-its-own-foundation%2F&data=02%7C01%7Cdarrel.miller%40microsoft.com%7Cfb5e0ed0bd52443c5f8708d835b08cb3%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C637318379733280445&sdata=ilTu%2F%2F1fGtPJS1fVC%2BoVZqW5jd0MxbcKNaxXyUAiqEU%3D&reserved=0>

thanks,
Rob

v2.23.0 | Report a Bug | By Email