From 431bc96dd76f15a5f3ab77d0e1cdeb05098771b9 Mon Sep 17 00:00:00 2001 From: apidesigner Date: Fri, 3 Feb 2017 10:04:18 +0000 Subject: [PATCH] Updates acknowledgements.md Auto commit by GitBook Editor --- acknowledgements.md | 6 ++++-- message/message-formats.md | 12 ++++++++++-- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/acknowledgements.md b/acknowledgements.md index b5678b6..8420c8e 100644 --- a/acknowledgements.md +++ b/acknowledgements.md @@ -3,8 +3,10 @@ This work is partly based on the work of many talented individuals and exception * [Mike Amundsen](http://amundsen.com/) * [Wesley Beary](http://geemus.com/) & [Heroku API Team](https://www.heroku.com/) +* [Mark Nottingham](https://www.mnot.net) * [Oldrich Novak](https://de.linkedin.com/in/oldrich-novak-1479124) & [adidas Architectural Team](http://www.adidas-group.com/en/) * [Stephen Mizell](http://smizell.com) * [Mark Foster]() -* [Apiary.io](https://apiary.io/) -* [Zalando API Team](http://zalando.github.io/restful-api-guidelines/) +* [Apiary.io](https://apiary.io) +* [Zalando API Team](http://zalando.github.io/restful-api-guidelines) + diff --git a/message/message-formats.md b/message/message-formats.md index c44e9ea..556a241 100644 --- a/message/message-formats.md +++ b/message/message-formats.md @@ -1,10 +1,18 @@ # Message Formats ## Response Message Format -All [`application/vnd.siren+json`](https://github.com/kevinswiber/siren) -[`application/problem+json`](https://tools.ietf.org/html/rfc7807) +All response messages MUST support the [`application/vnd.siren+json`](https://github.com/kevinswiber/siren) (Siren) format. +The format MUST not be used directly but instead it MUST be used as the base format for every application or domain-specific format. + +### Error Response Format +The [`application/problem+json`](https://tools.ietf.org/html/rfc7807) (Problem Detail) MUST be used in conjunction with Siren to communicate details about an error. ## Request Message Format [`application/x-www-form-urlencoded`](https://tools.ietf.org/html/rfc1866#section-8.2.1) [`application/json`](http://www.json.org) + + + + +