的Web Linking spec, RFC5988,如已在另一个答案已经指出,定义了一些不同类型的链接关系的。但它也指示IANA创建链接关系注册表并允许进一步链接关系注册。该注册表是公共链接关系的确切列表,可在iana.org/assignments/link-relations并且将在注册新关系时更新。
在HTTP API的
常用关系包括:
start
从集合(从每一个资源回API起点站)
item
(指向一个项目,例如从Twitter用户页面到鸣叫)
collection
(的item
反向)
previous
(这些接下来的四个是分页资源,例如收藏还是多页的文章)
next
first
last
create-form
(一个描述如何创建新的收藏项目,例如“新项目” HTML或XForms表单的资源点从集合)
edit-form
(点从一个形式的项用于编辑该项目,例如一个编辑资料Tweet按钮)
如果您希望的关系是而不是被该列表上的任何内容所覆盖,您的关系必须是URI。此外,建议将URI设为可控的域中的可忽略http URL,以便API客户端可以查找该关系的文档,例如, “HTTP://www.example.com/link-relations#tweets”。通常,您的API起始点将是一个集合列表,每个集合都有一个自定义链接关系,用于描述每个集合包含的资源类型。
我尽量避免RFC;)只是在开玩笑,尽管我很高兴我不是唯一一个总是带着更多问题而不是答案的人。 – Jammer