REST API в протокола HTTP

Като цяло при създаване на уебсайтове за получаване, създаване, промяна и изтриване на данни се използват само методите GET и POST, тъй като те се поддържат добре от браузъри и сървъри. Същото се отнася и за API-тата, предоставяни от сайтове. Съществуват обаче специални подходи, стандартизиращи API-тата за общо удобство както на разработчиците на API, така и на неговите потребители.

Един от подходите е REST API (често се казва RESTful, използвайки тази дума като прилагателно). В основата на това API стои широко използване на методите на протокола HTTP. В този подход с помощта на метода GET се получават данни, с помощта на метода POST се създават, с помощта на метода PUT се променят, а с помощта на метода DELETE - се изтриват.

За пример нека разгледаме някакво API, което манипулира потребители. Нека видим как ще изглеждат URL адресите за различни действия.

Получаваме всички потребители:

urlGET http://api.loc/users/

Получаваме един потребител по неговото id:

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

Създаваме потребител:

urlPOST http://api.loc/user/

Променяме потребител по неговото id:

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

Изтриваме потребител по неговото id:

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