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:
GET http://api.loc/users/
Marrim një përdorues sipas id të tij:
GET http://api.loc/user/1/
Krijojmë përdorues:
POST http://api.loc/user/
Ndryshojmë përdorues sipas id të tij:
PUT http://api.loc/user/1/
Fshijmë përdorues sipas id të tij:
DELETE http://api.loc/user/1/
Le të supozojmë se keni një API për produktet e një dyqani në internet. Përshkruani URL-të e dyqanit në mënyrë që API të bëhet RESTful.