Re: Link relation types for non-GET links

Klaus Hartke <hartke@tzi.org> Sat, 15 August 2015 12:28 UTC

Return-Path: <hartke@tzi.org>
X-Original-To: link-relations@ietfa.amsl.com
Delivered-To: link-relations@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2AB991A8823 for <link-relations@ietfa.amsl.com>; Sat, 15 Aug 2015 05:28:19 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.928
X-Spam-Level:
X-Spam-Status: No, score=-0.928 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, FM_FORGED_GMAIL=0.622, HELO_EQ_DE=0.35] autolearn=no
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 KecSdLhSnIsL for <link-relations@ietfa.amsl.com>; Sat, 15 Aug 2015 05:28:18 -0700 (PDT)
Received: from mailhost.informatik.uni-bremen.de (mailhost.informatik.uni-bremen.de [IPv6:2001:638:708:30c9::12]) (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 C3EF41A87ED for <link-relations@ietf.org>; Sat, 15 Aug 2015 05:28:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at informatik.uni-bremen.de
Received: from submithost.informatik.uni-bremen.de (submithost.informatik.uni-bremen.de [134.102.201.11]) by mailhost.informatik.uni-bremen.de (8.14.5/8.14.5) with ESMTP id t7FCSE3v006499 for <link-relations@ietf.org>; Sat, 15 Aug 2015 14:28:14 +0200 (CEST)
Received: from mail-io0-f180.google.com (mail-io0-f180.google.com [209.85.223.180]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by submithost.informatik.uni-bremen.de (Postfix) with ESMTPSA id 3mtgsB2mGrz4vkb for <link-relations@ietf.org>; Sat, 15 Aug 2015 14:28:14 +0200 (CEST)
Received: by iodt126 with SMTP id t126so109628334iod.2 for <link-relations@ietf.org>; Sat, 15 Aug 2015 05:28:12 -0700 (PDT)
X-Received: by 10.107.134.94 with SMTP id i91mr49487894iod.162.1439641692937; Sat, 15 Aug 2015 05:28:12 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.79.39.210 with HTTP; Sat, 15 Aug 2015 05:27:33 -0700 (PDT)
In-Reply-To: <CANqiZJZ-JwFi8DLGE1iBp9t88KYcE=y=vsPr5EEQ6bYuA96Kxw@mail.gmail.com>
References: <CAAzbHvb==Sn_4UUFHKs3H9GYbEfiX=TUjv4FSmNi9R4NEB+DvQ@mail.gmail.com> <CANqiZJZ-JwFi8DLGE1iBp9t88KYcE=y=vsPr5EEQ6bYuA96Kxw@mail.gmail.com>
From: Klaus Hartke <hartke@tzi.org>
Date: Sat, 15 Aug 2015 14:27:33 +0200
Message-ID: <CAAzbHvY=e3yFdP4tjR7EMvksE+gJDt+t6CpzfG0A1G=ZVusGpg@mail.gmail.com>
Subject: Re: Link relation types for non-GET links
To: Mike Kelly <mikekelly321@gmail.com>
Content-Type: text/plain; charset="UTF-8"
Archived-At: <http://mailarchive.ietf.org/arch/msg/link-relations/HEawLnvhoUjv4CY6ymQ_YaPy8dA>
Cc: link-relations@ietf.org
X-BeenThere: link-relations@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <link-relations.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/link-relations>, <mailto:link-relations-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/link-relations/>
List-Post: <mailto:link-relations@ietf.org>
List-Help: <mailto:link-relations-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/link-relations>, <mailto:link-relations-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 15 Aug 2015 12:28:19 -0000

Mike Kelly wrote:
> You can use a standard HAL link and a link relation if you ensure the link
> relation is a URL which can be dereferenced to retrieve a machine-readable
> description of the methods and messages that are possible for that link.
> Just think of it as machine readable link relation documentation.

That's an interesting idea. It basically adds a level of indirection,
which should be useful if many links have the same machine-readable
description of possible methods and payloads. However, I think I'd
prefer including that description directly at the link, so a client
does not have to dereference a URL to understand the link semantics.

Klaus