Re: [httpapi] Link Hints?

Evert Pot <me@evertpot.com> Fri, 21 July 2023 20:02 UTC

Return-Path: <me@evertpot.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 5B4A9C14CE2B for <httpapi@ietfa.amsl.com>; Fri, 21 Jul 2023 13:02:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.796
X-Spam-Level:
X-Spam-Status: No, score=-2.796 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, HTML_MESSAGE=0.001, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=evertpot.com header.b="CFxrpelA"; dkim=pass (2048-bit key) header.d=messagingengine.com header.b="xV09E7Ji"
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id RjhOtGTIyr16 for <httpapi@ietfa.amsl.com>; Fri, 21 Jul 2023 13:02:22 -0700 (PDT)
Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com [66.111.4.27]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 2990DC14F749 for <httpapi@ietf.org>; Fri, 21 Jul 2023 13:02:22 -0700 (PDT)
Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailout.nyi.internal (Postfix) with ESMTP id 4E29F5C006C for <httpapi@ietf.org>; Fri, 21 Jul 2023 16:02:21 -0400 (EDT)
Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Fri, 21 Jul 2023 16:02:21 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=evertpot.com; h= cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to; s=mesmtp; t=1689969741; x=1690056141; bh=sGAyGylz1hNNO0KqiLx315DGp8UOINPt9QfLYt/GJok=; b=CFxrpelAkeaK nsuCOvuiteFRTqD6M0sV6ARNomNvImFTZZCp2jY2R/IkCOXLfZSED856JnJTDezz OTMaZxUZtUC3ZMhQ6jthlPjZBJKG3qca5DaCecMa2LrLWtSctiUpbC7Gh5slcGTQ wgBoz2atR6bbL4IAmOYayBhP4SpX5vQ=
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; t=1689969741; x=1690056141; bh=sGAyGylz1hNNO 0KqiLx315DGp8UOINPt9QfLYt/GJok=; b=xV09E7JiOsd1djy6aLOjnMRHw59Iu Qlv3ez9+oq7RQKc/2uc7BK5e05u033E/31RNFYrFb4zU7v+Wp5gzjspGkPJGKVTT yxejmoTpAPQWO7AqVpuq+Kmn2AUiIgTF3C1sifpiD5esNJvfa2u6dRWMlp3ER90u toGyYNxU25ClukA8BVxX6dSc8ybMgKKfXHI5x6SmWixhlUWy+C470j7P1wa4fFiN lq0pjcIdrX02rby/CUwHx6mdfM3dhSHmimYJz+XT7QlFojOpioWNLSTqIUhQAiK1 ktSfX4pgglzh10PtN2vvHP3OVRXAZ3j4iip/WXW2lMn0dqLSoKiGSKBBA==
X-ME-Sender: <xms:TOS6ZPh1OLhRgGxNfGUWoIRCHLGprJYymhNCymrQuwc2pvUZGuvRbg> <xme:TOS6ZMAmnUJYIBPOO5fqpiejskYQ9Ue9A3iUxhsGLxppHdms2B_Kv13DQaLnmkhgR 1Wzeo_1fcwMIb7i>
X-ME-Received: <xmr:TOS6ZPFXGr6LGrWuOqpelfWtiT0WpKS-Re-6cHuXm3tDzidLmyrSC5S4IMxxipaWa94Livk_cHA09qlFNEozMvjJLImdtfwgnOi6r0gGCK70n-GrpLUeSIfER5Y9IQ>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedviedrhedvgddufeelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpegtkfffgggfuffvfhfhjgesrgdtre ertdefjeenucfhrhhomhepgfhvvghrthcurfhothcuoehmvgesvghvvghrthhpohhtrdgt ohhmqeenucggtffrrghtthgvrhhnpeetuefhjeetvdevfedvhfeigeeifeffvdffleelje fgudegudeffeehueefffeuleenucffohhmrghinhepihgvthhfrdhorhhgpdhgihhthhhu sgdrtghomhenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhroh hmpehmvgesvghvvghrthhpohhtrdgtohhm
X-ME-Proxy: <xmx:TOS6ZMRjSfFKPMKI1J1BZe7R7FYwlYsfbkzZK0_FCgMOWh11WhCwcA> <xmx:TOS6ZMxW1dg_60T_q1GYMaxXDQMHo8n9_oouEPDE8wc0gsAkbnvnXw> <xmx:TOS6ZC7Zx2sqc0oKL43_vNjLuSpmghvUswvqiYDBM5Kymt1TSBiFOA> <xmx:TeS6ZJtx13o-KrwPJ_dtJgEcwfsi7ctyFriRGLL06vVP3XiNCoOxfA>
Feedback-ID: i525c409a:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA for <httpapi@ietf.org>; Fri, 21 Jul 2023 16:02:20 -0400 (EDT)
Content-Type: multipart/alternative; boundary="------------zk5qoxUN3M7GJoBd4Ud2fjbs"
Message-ID: <8c021369-c493-eeef-85dc-cfc18ae4d2ef@evertpot.com>
Date: Fri, 21 Jul 2023 16:02:19 -0400
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.13.0
Content-Language: en-US
To: httpapi@ietf.org
References: <10303857-C095-44BB-850F-0F6B09D9C875@mnot.net>
From: Evert Pot <me@evertpot.com>
In-Reply-To: <10303857-C095-44BB-850F-0F6B09D9C875@mnot.net>
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/BbN491rM0Cd_k17Ud43q_veg8cw>
Subject: Re: [httpapi] Link Hints?
X-BeenThere: httpapi@ietf.org
X-Mailman-Version: 2.1.39
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: Fri, 21 Jul 2023 20:02:26 -0000

On 2023-07-19 17:02, Mark Nottingham wrote:

> Hi HTTP API folks,
>
> A longish time ago, I wrote a spec for 'HTTP link hints' that describe aspects of a HTTP resource in a fashion that's suitable for adorning links. For example, the media type(s) available on the other end, and the HTTP method(s) it might support.
>
>    https://datatracker.ietf.org/doc/draft-nottingham-link-hint/
>
> This is to a large degree paving the cowpaths that have been created in HTTP (e.g., the Allow header) and HTML (e.g., the 'type' attribute on links) in a way that they can be used in anyplace a link can. It's also a way of coordinating common link attributes, because RFC8288 makes attributes per-format.
>
> I didn't push for standardisation because I wanted to make sure there was actual need for it / interest in it. I've heard some of that in backchannel recently, and was wondering what the WG thought about adopting this (or something like it).
>
> Cheers,
>
>
> P.S. Chairs I'm happy to chat about this for a few minutes next week if there's time in the meeting. If not, no worries.
We've adopted Link hints many years ago, and used it in several 
projects. Some of those open source:

https://github.com/badgateway/ketting
https://github.com/curveball/browser

We really like it. Great set of tools to build self-describing APIs. 
We've primarily used this to extend the HAL format. Would love to see 
this adopted.

Evert