HTTP хаттамасындағы REST API

Әдетте, сайттарды жасаған кезде деректерді алу, жасау, өзгерту және жою үшін тек 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/