REST API v protokolu HTTP

Zpravidla při tvorbě webových stránek pro získání, vytvoření, změnu a odstranění dat se používají pouze metody GET a POST, protože jsou dobře podporovány prohlížeči a servery. To samé platí i pro API poskytovaná weby. Existují však speciální přístupy, standardizující API pro obecné pohodlí jak vývojářů API, tak jeho uživatelů.

Jedním z přístupů je REST API (často se říká RESTful, přičemž toto slovo se používá jako přídavné jméno). Základem tohoto API je široké použití metod protokolu HTTP. V tomto přístupu se pomocí metody GET získávají data, pomocí metody POST vytvářejí, pomocí metody PUT mění a pomocí metody DELETE - odstraňují.

Jako příklad uvažujme nějaké API, které manipuluje s uživateli. Podívejme se, jak budou vypadat URL pro různé akce.

Získáme všechny uživatele:

urlGET http://api.loc/users/

Získáme jednoho uživatele podle jeho id:

urlGET http://api.loc/user/1/

Vytvoříme uživatele:

urlPOST http://api.loc/user/

Změníme uživatele podle jeho id:

urlPUT http://api.loc/user/1/

Odstraníme uživatele podle jeho id:

urlDELETE http://api.loc/user/1/