Re: Communicating Warning Information in HTTP APIs

Mark Nottingham <mnot@mnot.net> Wed, 06 November 2019 05:53 UTC

Return-Path: <ietf-http-wg-request+bounce-httpbisa-archive-bis2juki=lists.ie@listhub.w3.org>
X-Original-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Delivered-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 35C4E1201EA for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Tue, 5 Nov 2019 21:53:49 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.751
X-Spam-Level:
X-Spam-Status: No, score=-2.751 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.25, MAILING_LIST_MULTI=-1, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mnot.net header.b=dlKhZ+Ho; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=SJo0j9DX
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 9kiviPj-TxDM for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Tue, 5 Nov 2019 21:53:46 -0800 (PST)
Received: from frink.w3.org (frink.w3.org [IPv6:2603:400a:ffff:804:801e:34:0:38]) (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 D40C312002E for <httpbisa-archive-bis2Juki@lists.ietf.org>; Tue, 5 Nov 2019 21:53:45 -0800 (PST)
Received: from lists by frink.w3.org with local (Exim 4.89) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1iSEDn-0005eO-4r for ietf-http-wg-dist@listhub.w3.org; Wed, 06 Nov 2019 05:51:11 +0000
Resent-Date: Wed, 06 Nov 2019 05:51:11 +0000
Resent-Message-Id: <E1iSEDn-0005eO-4r@frink.w3.org>
Received: from titan.w3.org ([2603:400a:ffff:804:801e:34:0:4c]) by frink.w3.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from <mnot@mnot.net>) id 1iSEDl-0005dc-56 for ietf-http-wg@listhub.w3.org; Wed, 06 Nov 2019 05:51:09 +0000
Received: from out4-smtp.messagingengine.com ([66.111.4.28]) by titan.w3.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from <mnot@mnot.net>) id 1iSEDg-0004sb-SZ for ietf-http-wg@w3.org; Wed, 06 Nov 2019 05:51:09 +0000
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id CF47320A82; Wed, 6 Nov 2019 00:51:01 -0500 (EST)
Received: from mailfrontend2 ([10.202.2.163]) by compute3.internal (MEProxy); Wed, 06 Nov 2019 00:51:01 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mnot.net; h= content-type:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; s=fm1; bh=l LTKnuUAA+Gc/Zc3AsB4v4modTfMf8N0xDhUB+gIbps=; b=dlKhZ+HoGu5uvO3gq /5xMTiGEQOC+UMh8EaSKbO4MEpKY68FZzI7LRx2Fo8RNH+fFQCd63MITdsPWdlwM 4FLfmlzsDz3rUKCpYzpJQrmh8vBUJLdL8ebqLNwf30w20PDv+YPX5QdXToL3+EcJ 7QvvBxsQsHH6hcCjbay2tYqZZ4zRx7Qop+yJpiPryNv7PB2U9kZiRYZFvNCch79S veu/UlIP/u/ms5u2MHh3zZJSPPeBjBfO26w89MpZdbpWfbBdsoMhf97CqpItKUg+ w5Aw5dllSMOAhi8bWh86cDNsSCpiC1J2G/4uq2YgxzpuPXg2qQ0eN2D8e2ShH3/1 PJD7Q==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=lLTKnuUAA+Gc/Zc3AsB4v4modTfMf8N0xDhUB+gIb ps=; b=SJo0j9DXedPcdyGrOtOKADcC58k2J/v7X7IX9LfPEkIUwaWAuzsnFT+k7 BMzYmAyUNVY4DnyUTt+PKcws0mMxwD8gZpeWvXPCltcyKd2+cAJpInz6/J6Ys0XT UopPIC1TqLWJ2od9H/EKs22GRVR/OZaBeYL78t/Rwg7Q9fM0hbZXFAl2hAEo4iwq qptNp6Co57ckEHTzcxNyeobEk3jQBP3wgcNdqwCvqH1D3mHe/bS+WbszY+70Bb/e lLA4WCfHJTFuJFjjAkWZC2txX0gwmmxqEkOTztyla+W9ygwBzsLiqV7rC05oSFSX QUFif/ctuDDCp91q/9ahxxBcNiQFg==
X-ME-Sender: <xms:RF_CXcFak-BBK-r5LyzoYDk0ThqwuE68Iia1GUbIZPHzfz-gqumpRA>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedufedrudduiedgkeekucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurheptggguffhjgffgffkfhfvofesthhqmhdthhdtjeenucfhrhhomhepofgrrhhk ucfpohhtthhinhhghhgrmhcuoehmnhhothesmhhnohhtrdhnvghtqeenucffohhmrghinh epghhithhhuhgsrdgtohhmpdhivghtfhdrohhrghdpmhhnohhtrdhnvghtnecukfhppedu udelrddujedrudehkedrvdehudenucfrrghrrghmpehmrghilhhfrhhomhepmhhnohhtse hmnhhothdrnhgvthenucevlhhushhtvghrufhiiigvpedt
X-ME-Proxy: <xmx:RF_CXaWnWFAc6l8YPxOW_9-n-HLAyeANMqk89tn0UYapPXc76XbqgQ> <xmx:RF_CXXBm5pl5sCAZiag_Dvd0BWG-BS6pp3V-Fl5hE-8LFu8Ao4Ch2A> <xmx:RF_CXT2BIOuI6WzvnRn4KZZAsxUrSedxgkElNHktucgSyguXL72kmA> <xmx:RV_CXeOQSuhzqZEnQ0HM5xhMshBR34T4EU4kBxpCJ6APSt66J0EBMA>
Received: from macbook-pro.mnot.net (unknown [119.17.158.251]) by mail.messagingengine.com (Postfix) with ESMTPA id DEF3D306005C; Wed, 6 Nov 2019 00:50:59 -0500 (EST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3601.0.10\))
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <CAEQcYZgHNcOv5tMv+E4oRJs8rpSugEPcT=NaZAM53v=0nkotcQ@mail.gmail.com>
Date: Wed, 06 Nov 2019 16:50:54 +1100
Cc: ietf-http-wg@w3.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <BE72503E-FBB1-43A9-BF22-AAC37B11D63D@mnot.net>
References: <CAEQcYZgHNcOv5tMv+E4oRJs8rpSugEPcT=NaZAM53v=0nkotcQ@mail.gmail.com>
To: André Cedik <andre.cedik@googlemail.com>
X-Mailer: Apple Mail (2.3601.0.10)
Received-SPF: pass client-ip=66.111.4.28; envelope-from=mnot@mnot.net; helo=out4-smtp.messagingengine.com
X-W3C-Hub-Spam-Status: No, score=-9.8
X-W3C-Hub-Spam-Report: BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, W3C_AA=-1, W3C_DB=-1, W3C_IRA=-1, W3C_IRR=-3, W3C_WL=-1
X-W3C-Scan-Sig: titan.w3.org 1iSEDg-0004sb-SZ 982a9606db325133eb3591012fcab4e7
X-Original-To: ietf-http-wg@w3.org
Subject: Re: Communicating Warning Information in HTTP APIs
Archived-At: <https://www.w3.org/mid/BE72503E-FBB1-43A9-BF22-AAC37B11D63D@mnot.net>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/37127
X-Loop: ietf-http-wg@w3.org
Resent-Sender: ietf-http-wg-request@w3.org
Precedence: list
List-Id: <ietf-http-wg.w3.org>
List-Help: <https://www.w3.org/Mail/>
List-Post: <mailto:ietf-http-wg@w3.org>
List-Unsubscribe: <mailto:ietf-http-wg-request@w3.org?subject=unsubscribe>

Hi André,

My .02 is that Warning's semantics are not consistently used or implemented by intermediaries, which makes it less than useful. Its syntax is also... not great.

If you have use cases, I'd recommend minting a new header field and starting fresh, rather than trying to reuse it.

Cheers,


> On 6 Nov 2019, at 5:58 am, André Cedik <andre.cedik@googlemail.com> wrote:
> 
> Hey everyone,
> 
> Erik Wilde submitted an I-D on Monday - using the subject of this mail as the title (see https://datatracker.ietf.org/doc/draft-cedik-http-warning/) - that he and I wrote. It is our goal "to allow HTTP providers to have a standardized way of communicating to their consumers that while the response can be considered to be a non-failure, there is some warning information available that they might want to take into account".
> 
> Shortly after we submitted the draft Julian Reschke notified us (see https://github.com/dret/I-D/issues/125) that the Warning header is bound to be removed with the next spec (draft-ietf-httpbis-cache). Which is very unfortunate for the I-D since we wanted to use it for indicating that the client would find additional information within the response body. 
> 
> Since there is currently no other way of conveying this to an http client (that we know of), we'd really like to get feedback if this is a use case for which you would be willing to keep the Warning header or if there is another way to make something like this possible.
> 
> Best
> André Cedik 

--
Mark Nottingham   https://www.mnot.net/