REST API në protokollin HTTP

Si rregull, gjatë krijimit të faqeve të internetit për marrjen, krijimin, ndryshimin dhe fshirjen e të dhënave përdoren vetëm metodat GET dhe POST, pasi ato mbështeten mirë nga shfletuesit dhe serverat. E njëjta gjë vlen edhe për API-të që ofrohen nga faqet e internetit. Megjithatë, ekzistojnë qasje të specializuara që standardizojnë API-të për lehtësi të përgjithshme si për zhvilluesit e API, ashtu edhe për përdoruesit e tij.

Një nga qasjet është REST API (shpesh thuhet RESTful duke e përdorur këtë fjalë si mbiemër). Baza e këtij API qëndron në përdorimin e gjerë të metodave të protokollit HTTP. Në këtë qasje, me ndihmën e metodës GET merren të dhënat, me ndihmën e metodës POST krijohen, me ndihmën e metodës PUT ndryshohen, dhe me ndihmën e metodës DELETE - fshihen.

Për shembull, le të shqyrtojmë një API të caktuar, që manipulon përdorues. Le të shohim, se si do të dukeshin URL-të për veprime të ndryshme.

Marrim të gjithë përdoruesit:

urlGET http://api.loc/users/

Marrim një përdorues sipas id të tij:

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

Krijojmë përdorues:

urlPOST http://api.loc/user/

Ndryshojmë përdorues sipas id të tij:

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

Fshijmë përdorues sipas id të tij:

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