REST API дар протоколи HTTP
Ҳамчун қоида, дар эҷоди сомонаҳо барои гирифтан, эҷод кардан, тағйир додан ва нест кардани маълумот танҳо усулҳои GET ва POST истифода мешаванд, зеро ки онҳо аз тарафи браузерҳо ва серверҳо хуб дастгирӣ мешаванд. Ҳамин чиз ба API-ҳое, ки аз тарафи сомонаҳо пешниҳод мешаванд, низ дахл дорад. Аммо, равишҳои махсусе мавҷуданд, ки API-ро барои осоишти умумии ҳам таҳиягарони API ва ҳам корбарони он стандартизатсия мекунанд.
Яке аз ин равишҳо REST API мебошад (аксар вақт мегӯянд RESTful, ин калимаро ҳамчун сифат истифода мебаранд). Дар асоси ин API истифодаи васеи усулҳои протоколи HTTP ҷойгир аст. Дар ин равиш бо ёрии усули GET маълумотҳо гирифта мешаванд, бо усули POST эҷод мешаванд, бо усули PUT тағйир дода мешаванд, ва бо усули DELETE - нест карда мешаванд.
Барои мисол биёед як API-ро дида бароем, ки бо корбарон кор мекунад. Биёед бубинем, ки URL барои амалҳои гуногун чӣ хел менамояд.
Ҳамаи корбаронро мегирем:
GET http://api.loc/users/
Як корбарро аз рӯи id-и ӯ мегирем:
GET http://api.loc/user/1/
Корбар месозем:
POST http://api.loc/user/
Корбарро аз рӯи id-и ӯ тағйир медиҳем:
PUT http://api.loc/user/1/
Корбарро аз рӯи id-и ӯ нест мекунем:
DELETE http://api.loc/user/1/
Фарз кунем, ки шумо API-и маҳсулоти интернет мағоза доред. URL-ҳои мағозароро тавре нависед, то ки API RESTful шавад.
