From nobody Sat Jan 16 13:41:48 2021 Return-Path: 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 5E1843A19E8 for ; Sat, 16 Jan 2021 13:41:46 -0800 (PST) X-Virus-Scanned: amavisd-new at amsl.com X-Spam-Flag: NO X-Spam-Score: -2.35 X-Spam-Level: X-Spam-Status: No, score=-2.35 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.25, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H2=-0.001, 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 mk2YAtEoQlBG for ; Sat, 16 Jan 2021 13:41:44 -0800 (PST) Received: from NAM06-DM3-obe.outbound.protection.outlook.com (mail-eopbgr640117.outbound.protection.outlook.com [40.107.64.117]) (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 C26D23A19E6 for ; Sat, 16 Jan 2021 13:41:44 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=hppQQfPGPOOcq2I51v3/x0ubGHhCoZ1F1RDMwMRQRQ2XHxZkuN1/Klc/95rlGFSUIOAI0z6mlinTgFkj71zlQABd1xAt2TvylYyl2wdP6kR75ahcNSuTmxTcfy1XXrzbyCJDFQstXRq4gkdCqNdj+KaJCNI56Oe4vzz5RwnXZzi0SliWPzAI++55qVTM6XnisQIx/wQOXMScLaQkBJXMNLt2Xu2Nz2lZdgnMJvNcLvWZKbZSMBlXaZbBAJhLEEFNSQQY5t1HaQWlVUyY9KiWY3t0Uj81yCPUxnmlJT3eJV9SPSfdD4gjUPtb2QYH0+mKbG3m9zKICBGzSHTnLF+7Vg== 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=vPSvQTeitqYrcOHDtdExf1pb1As6o8OB6U1JL+Ttuac=; b=E0XvNPRn1q7yRP89CVjSLSaPyg//yFtmHImHaceK2Ivis14cFkg0efOvmtLw2OwkplIJIYbIi9vhjZNS3w8hi52Ix9/gLiI5Nmft8dzubQIZuGUT7dgwRxyi54xG78Tr1NAiOE5W355dzj3UsdyXMfp8IaBxx32M04f7vm19Cr+ER+ED50V4mpnkcwjG3xM2W+/Faton7wStiqT53dyAMlZL5pXyaHkII3DHH+Ro5sgu1aoHC7SqA+VUBjKTGCp6jigVF4EP4pIgLFsfqoStcqgRVpmTlXVfxs/MsCpEsbH8BjuDeruxtBr9nbOLDB8iGJaWe+AiVB1AiBVrmpQ+Lw== 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=vPSvQTeitqYrcOHDtdExf1pb1As6o8OB6U1JL+Ttuac=; b=ZCsrWp2L1ItgsTKi2IpWNF59XqGNPfdj8qudmZvDO0F1dhbBLcbaNVpaQfEBHXxA60MAXGSf34RDnz6T6idK0XZRCFhNyV1vBG9H5HnnIjRrE9sSjHtB1ed0YDtyDukAuZsruNQdLZcEaHCrMLf0y1CygMJG4GTHiaXj1Pq5uX0= Received: from (2603:10b6:5:1bc::23) by DM6PR00MB0766.namprd00.prod.outlook.com (2603:10b6:5:20b::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3807.0; Sat, 16 Jan 2021 21:41:37 +0000 Received: from DM6PR00MB0845.namprd00.prod.outlook.com ([fe80::6450:8a43:1d66:8d3d]) by DM6PR00MB0845.namprd00.prod.outlook.com ([fe80::6450:8a43:1d66:8d3d%5]) with mapi id 15.20.3812.000; Sat, 16 Jan 2021 21:41:37 +0000 From: Darrel Miller To: "sanjay.dalal@cal.berkeley.edu" , "httpapi@ietf.org" Thread-Topic: [httpapi] rfc7807 errata or just "more" Thread-Index: AQHW63flyWs2GD/CXEa43IG2VCAgqKoqxvae Date: Sat, 16 Jan 2021 21:41:37 +0000 Message-ID: References: In-Reply-To: Accept-Language: en-US Content-Language: en-US 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=2021-01-16T21:41:37.745Z; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Name=General; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_ContentBits=0; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Method=Standard; authentication-results: cal.berkeley.edu; dkim=none (message not signed) header.d=none;cal.berkeley.edu; dmarc=none action=none header.from=microsoft.com; x-originating-ip: [74.15.147.35] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: b35c13bb-b0db-4ff5-5351-08d8ba678096 x-ms-traffictypediagnostic: DM6PR00MB0766: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: xazfIbdDFiYZrT54Jq9tK5Iu/ukAakDIcfQxTHB+6MVTdsJXjjv4ZDW20Z57CPETZXzY8U0/+/PPPv0N1RQAOnpgE2rJh/b3qjPPVOpZH3Jv7qdkGSnv5xe5OoPUonZ4z73PYwtVyB0u/C5B4SQZklHCx6EED3MmyivS+5Qb7VieQ7TSdqU36DV5cG6BpU3PXGc1u31XvN0KzrhTWIlsrkd4FMahatgC1KKXgAQnOAY7n7ZjoM+Qc38mqO4Os9Q0Y9yfPRZCA9njMjTurru3I0NvHdqQs+EAy8VZkGstYrcFTGGHQ/qOopx459W2G16AEZMmlSwDWMPB949zFm+L3e3cJraiUaIfwLMXsiw40PBInET9ZP9l9qmd8s1x7NTIRsm6AKf8hqNdAz86DB7zp9TDMg3yFa9is1ksI/qNPDpvtx5WbYW0KL+t6Ishke3+dOVq7pD3tTdBC8xQO3znvvzRMFclzEg/Ur0crbeOLSou409yXeOFHKRBeTHWsRK/pKbaGx5R5BRQfHFS8bVK8w== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR00MB0845.namprd00.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(376002)(366004)(136003)(346002)(396003)(39860400002)(55016002)(9686003)(8676002)(5660300002)(10290500003)(8990500004)(186003)(76116006)(6506007)(83380400001)(71200400001)(33656002)(64756008)(52536014)(66446008)(66476007)(478600001)(66946007)(19627405001)(7696005)(86362001)(110136005)(8936002)(2906002)(82950400001)(316002)(26005)(66556008)(82960400001); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata: =?iso-8859-1?Q?qkDcofNE7Bz6S1B8CwILrP0UKzdyY8a8hsIFwS4JJCqIhekr3uz6W75win?= =?iso-8859-1?Q?FFjfwKlpfa3/gqWjELgLbiwi6lfCAF9x3JijZw/KXbtYdCv/G3vKJjUrqM?= =?iso-8859-1?Q?Dpl+O5b9tnm2o5mcwYl8obhYi74n2N3+3N4Fcv4CnfDOG1O4ex14mCZvAp?= =?iso-8859-1?Q?snmdSt5N0c3jLa1y9sALgE1Gr0afW3GgDDjLj5w+ybaKGz3ZIU35cjRkaj?= =?iso-8859-1?Q?BXVxddRck8rAyA9Qd1jKhYrIVoZ/BuN49BZvh7MA8eubIfegAmnBe2YRLg?= =?iso-8859-1?Q?5xOfVZmT4rhnTsgsZ/zGOPOd1EhCrUUSC2ce4kOy90Oaj+7WcWXWpAQVhE?= =?iso-8859-1?Q?vnESYny9fES3iN5CUjfdTmwMGne6dVP32YzkL+Yox+HO1HL5L8Ru39jyaZ?= =?iso-8859-1?Q?NHnh4youbCrFQne07pVa2Gg+On6w2LJ+OQ4u1dtFQccpcpAoSRj6h9xvIh?= =?iso-8859-1?Q?+AWAld4bbS+9lDzN1JkhwwZqENmFvSRIDnCIj8A5+r6lpUiXvWvBtMfrwi?= =?iso-8859-1?Q?7UXPz/2da1/m1L275NVu+8lPgq2MZNAudZ42DcRfAbw1bdLpASRNEXPQsa?= =?iso-8859-1?Q?D1YLYvXHWMAIAR8mn59DvxVj+KcwfjySymoQV/9l8cGC6klWRL+z/lHCV0?= =?iso-8859-1?Q?TEYQHi0yi73w9KWgm7gCU7Zun08yxELCMN0YaiA6Su39Wtg1mZ/gtVY272?= =?iso-8859-1?Q?1Yb1ceTu0aopPhJ2N/7ZgEap9avbNdVs+jNgR0iYIBFSocXmJ1Wx5Sple6?= =?iso-8859-1?Q?/JALb5dLToYAES/j2eyk5pmzlHsytKD7TehLvW4o40msze8VnJIjOIHBR3?= =?iso-8859-1?Q?8W5mVjcFTKCLrSh3PTreZIBA2QZkwtYBPsM9mwFbK6te8MuWOzO3qfaBvn?= =?iso-8859-1?Q?ua0eb4bGEwk0W0U2rDZH3ll3GTJhRouaV/HsssyPb/FvaBVF2YlQzQK1I5?= =?iso-8859-1?Q?v8N4gyP7gC7D+k9RV5HON9UtRGalCH64ocbFVtcmWpb7c99F7ENDRoyM9x?= =?iso-8859-1?Q?LSAltQGDR/VaSwLe4l5GA927vhr9Lu8iU+0fFiypg3ia2Iq3H5UVvz0cRv?= =?iso-8859-1?Q?BSnN1Fc03mwhUZ/z1O/WEzWvr7b2SxIkIoFrTVlqIb0C?= x-ms-exchange-transport-forked: True Content-Type: multipart/alternative; boundary="_000_DM6PR00MB08454A51EFCF8675F426EDA7F0A69DM6PR00MB0845namp_" MIME-Version: 1.0 X-OriginatorOrg: microsoft.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM6PR00MB0845.namprd00.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: b35c13bb-b0db-4ff5-5351-08d8ba678096 X-MS-Exchange-CrossTenant-originalarrivaltime: 16 Jan 2021 21:41:37.2935 (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: fpH9rYco58/LxH6f3HFSLK5n6eHtbePxDa8Z/j4ILjAB8lVHjgOZhsE5oAibs7MZ2IbX2G4OgqaXPawAeW52iQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR00MB0766 Archived-At: Subject: Re: [httpapi] rfc7807 errata or just "more" X-BeenThere: httpapi@ietf.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Building Blocks for HTTP APIs List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 16 Jan 2021 21:41:46 -0000 --_000_DM6PR00MB08454A51EFCF8675F426EDA7F0A69DM6PR00MB0845namp_ Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Hi Sanjay, From: httpapi on behalf of Sanjay Dalal As you know, having multiple schema validation related errors in payload of= HTTP requests is a very common scenario for the HTTP APIs. I'm not sure an instances array is going to solve the issue here. In your = example, at the resource level, multiple issues have been detected as schem= a validation problems and you will need some explicit type to identify sche= ma validation problems.. As you say there may be many validation constrain= ts that were violated within the response payload. However, it is likely t= hat they are more than one type of validation failure. Just pointing to th= e instances of the failures without describing what kind of failures those = are would not be a great experience. That additional information about wha= t kind of failures each of those instances experienced is going to need to = be in extensions and the client will need to understand the semantics of th= e type. I accept there will be some scenarios where there are multiple instances of= problems associated to a single resource that are homogeneous, but there a= re going to be just as many that are heterogenous. I don't really see the = issue with using the type to define the necessary extensions. Darrel --_000_DM6PR00MB08454A51EFCF8675F426EDA7F0A69DM6PR00MB0845namp_ Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
Hi Sanjay,

From: httpapi <httpapi-b= ounces@ietf.org> on behalf of Sanjay Dalal 

As you know, having multiple schema v= alidation related errors in payload of HTTP requests is a very common scena= rio for the HTTP APIs. 

I'm not sure an instances array is go= ing to solve the issue here.  In your example, at the resource level, = multiple issues have been detected as schema validation problems and you wi= ll need some explicit type to identify schema validation problems..  As you say there may be many validation constr= aints that were violated within the response payload.  However, it is = likely that they are more than one type of validation failure.  Just p= ointing to the instances of the failures without describing what kind of failures those are would not be a great experience= .  That additional information about what kind of failures each of tho= se instances experienced is going to need to be in extensions and the clien= t will need to understand the semantics of the type.

I accept there will be some scenarios= where there are multiple instances of problems associated to a single reso= urce that are homogeneous, but there are going to be just as many that are = heterogenous.  I don't really see the issue with using the type to define the necessary extensions.

Darrel

--_000_DM6PR00MB08454A51EFCF8675F426EDA7F0A69DM6PR00MB0845namp_--