IETF Logo Mail Archive

Re: [httpapi] rfc7807 errata or just "more"

Darrel Miller <Darrel.Miller@microsoft.com> Sat, 16 January 2021 21:41 UTC

Return-Path: <Darrel.Miller@microsoft.com>
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 <httpapi@ietfa.amsl.com>; 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 <httpapi@ietfa.amsl.com>; 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 <httpapi@ietf.org>; 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 <Darrel.Miller@microsoft.com>
To: "sanjay.dalal@cal.berkeley.edu" <sanjay.dalal@cal.berkeley.edu>, "httpapi@ietf.org" <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: <DM6PR00MB08454A51EFCF8675F426EDA7F0A69@DM6PR00MB0845.namprd00.prod.outlook.com>
References: <CAC5fHGPAVBKiV81bTGpm3BwwfRT-UZw732okCA7d9TTBBwGvGQ@mail.gmail.com>
In-Reply-To: <CAC5fHGPAVBKiV81bTGpm3BwwfRT-UZw732okCA7d9TTBBwGvGQ@mail.gmail.com>
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: <DM6PR00MB0766054806832B4A2B8C1681F0A69@DM6PR00MB0766.namprd00.prod.outlook.com>
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: qkDcofNE7Bz6S1B8CwILrP0UKzdyY8a8hsIFwS4JJCqIhekr3uz6W75winFFjfwKlpfa3/gqWjELgLbiwi6lfCAF9x3JijZw/KXbtYdCv/G3vKJjUrqMDpl+O5b9tnm2o5mcwYl8obhYi74n2N3+3N4Fcv4CnfDOG1O4ex14mCZvApsnmdSt5N0c3jLa1y9sALgE1Gr0afW3GgDDjLj5w+ybaKGz3ZIU35cjRkajBXVxddRck8rAyA9Qd1jKhYrIVoZ/BuN49BZvh7MA8eubIfegAmnBe2YRLg5xOfVZmT4rhnTsgsZ/zGOPOd1EhCrUUSC2ce4kOy90Oaj+7WcWXWpAQVhEvnESYny9fES3iN5CUjfdTmwMGne6dVP32YzkL+Yox+HO1HL5L8Ru39jyaZNHnh4youbCrFQne07pVa2Gg+On6w2LJ+OQ4u1dtFQccpcpAoSRj6h9xvIh+AWAld4bbS+9lDzN1JkhwwZqENmFvSRIDnCIj8A5+r6lpUiXvWvBtMfrwi7UXPz/2da1/m1L275NVu+8lPgq2MZNAudZ42DcRfAbw1bdLpASRNEXPQsaD1YLYvXHWMAIAR8mn59DvxVj+KcwfjySymoQV/9l8cGC6klWRL+z/lHCV0TEYQHi0yi73w9KWgm7gCU7Zun08yxELCMN0YaiA6Su39Wtg1mZ/gtVY2721Yb1ceTu0aopPhJ2N/7ZgEap9avbNdVs+jNgR0iYIBFSocXmJ1Wx5Sple6/JALb5dLToYAES/j2eyk5pmzlHsytKD7TehLvW4o40msze8VnJIjOIHBR38W5mVjcFTKCLrSh3PTreZIBA2QZkwtYBPsM9mwFbK6te8MuWOzO3qfaBvnua0eb4bGEwk0W0U2rDZH3ll3GTJhRouaV/HsssyPb/FvaBVF2YlQzQK1I5v8N4gyP7gC7D+k9RV5HON9UtRGalCH64ocbFVtcmWpb7c99F7ENDRoyM9xLSAltQGDR/VaSwLe4l5GA927vhr9Lu8iU+0fFiypg3ia2Iq3H5UVvz0cRvBSnN1Fc03mwhUZ/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: <https://mailarchive.ietf.org/arch/msg/httpapi/EVSb-mWoyZzjIsWh3hsaqBjGfSI>
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 <httpapi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/httpapi>, <mailto:httpapi-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi/>
List-Post: <mailto:httpapi@ietf.org>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/httpapi>, <mailto:httpapi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 16 Jan 2021 21:41:46 -0000

Hi Sanjay,

From: httpapi <httpapi-bounces@ietf.org> 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 schema validation problems and you will need some explicit type to identify schema validation problems..  As you say there may be many validation constraints that were violated within the response payload.  However, it is likely that they are more than one type of validation failure.  Just pointing 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 those instances experienced is going to need to be in extensions and the client 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 resource 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

v2.23.0 | Report a Bug | By Email