Suponha que eu escreva um serviço REST cuja intenção seja adicionar um novo item de dados a um sistema.

Eu pretendo postar para

http://myhost/serviceX/someResources

Suponha que funcione, que código de resposta devo usar? E que conteúdo devo retornar.

Eu estou olhando para odefinições dos códigos de resposta HTTP e veja estas possibilidades:

200: Retornouma entidade que descreve ou contém o resultado da ação;

201: o que significa CREATED. Significado * A solicitação foi atendida e resultou na criação de um novo recurso. O recurso recém-criado pode ser referenciado pelos URIs retornados na entidade da resposta, com o URI mais específico para o recurso fornecido por um campo de cabeçalho Local. A resposta DEVE incluir uma entidade que contenha uma lista de características de recursos e localizações a partir das quais o usuário ou agente de usuário possa escolher o mais apropriado. O formato da entidade é especificado pelo tipo de mídia fornecido no campo de cabeçalho Content-Type. *

O último parece mais de acordo com as especificações Http, mas não estou absolutamente claro o que

A resposta DEVE incluir uma entidade que contenha uma lista de características e localizações de recursos

significa.

Recomendações? Interpretações?