Costumo ver o seguinte em documentos HTML
<link rel="self" href="http://example.com/something">
ou assim em JSON
link: {
rel="self",
href="http://example.com/something"
}
ou em XML
<atom:link rel="self" href="http://example.com/something" />
Então, eu tive algumas perguntas:
- Por que incluir este link? Que vantagem isso traz? (Diga-me que há uma razão para isso e não é apenas um talismã de "boas práticas")
- Como devo explorar esse link em meus clientes? Quais são os casos de uso desse link?
- Quando não devo usar este link? Quando é inútil incluí-lo?
Respostas:
Como é uma referência própria, o cliente saberá que o IRI (
http://example.com/something
) é um identificador do recurso sobre o qual a representação se refere.Pode ser importante quando seu recurso pode ter vários identificadores, por exemplo,
http://example.com/users/1
ehttp://example.com/users/1?fields="name"
pode identificar o mesmo recurso, mas um GET neles pode resultar em representações diferentes.Por tipos de mídia como o HAL, você também usa isso para identificar recursos incorporados. Por exemplo:
fonte