Message Design

Kromě URL a HTTP metody musí být při návrhu REST API velmi dobře navržené struktury odesílané v HTTP požadavku a odpovědi.

Struktury by měly být navrženy tak, aby je bylo možné reprezentovat pomocí různých media types a aby v každém media type dodržovaly všechny běžné standardy a konvence.

Response body by mělo být odesláno jako součást HTTP odpovědi ve všech případech až na výjimky, které vychází ze standardů. Důležité je vrátit response body také na základě HTTP požadavku klienta s použitím metod POST, PUT nebo PATCH. Nechcete-li response body vracet, na konci článku se dočtete o možnosti, jak tento požadavek řešit.

V případě request body i response body do..." >