Я разрабатываю RESTful API и в попытке описать и сделать документацию более ясной. Я хочу объявить свой HTTP-заголовок типа контента следующим образом:
Content-Type: application/vnd.mycorp.mydatatype+json
где mycorp является идентификатором, уникальным для моей корпорации, а mydatatype уникален для каждого типа данных. Примером может служить:
Content-Type: application/vnd.ford.car+json
{
"manufactured_year": 2000
, "color": "blue"
, "hp": 160
, "model" "Focus"
, "type": "sedan"
}
Этот тип содержимого потребуется для того, чтобы POST был действительным и будет отправлен как часть ответа. Мне кажется, что это хороший способ определить правила для того, что должно быть внутри полезной нагрузки.
Я не могу найти хороший ресурс о том, является ли это хорошей идеей или если это даже допускается стандартами IETF.
Итак, вопрос: что более реально, application/vnd.mycorp.mydatatype + json или просто application/json?