Īsā atbilde
REST API ir izplatītākais veids, kā veidot API tīmekļa sistēmās. Tas izmanto parastos HTTP pieprasījumus — tāpat kā pārlūks — ar skaidrām adresēm resursiem (piemēram, /orders) un darbībām GET (iegūt), POST (izveidot), PUT/PATCH (mainīt) un DELETE (dzēst). Dati parasti tiek nodoti JSON formātā.
Kā REST API izskatās
GET /orders— iegūt pasūtījumu sarakstu.GET /orders/123— iegūt konkrētu pasūtījumu.POST /orders— izveidot jaunu pasūtījumu.PATCH /orders/123— mainīt pasūtījuma statusu.
Atbilde nāk JSON formātā — strukturētā tekstā, ko viegli apstrādā jebkura programmēšanas valoda.
Kāpēc REST ir tik izplatīts
- Vienkāršs un saprotams.
- Darbojas ar parasto HTTP protokolu, tāpat kā mājaslapas.
- To atbalsta praktiski visas programmēšanas valodas un ietvari.
- Viegli dokumentēt — bieži ar OpenAPI (Swagger) aprakstu.
Citi API veidi
- GraphQL — klients pats norāda, kādus datus vēlas saņemt.
- SOAP — vecāks, XML balstīts standarts, ko joprojām izmanto daudzas valsts un bankas sistēmas.
- Webhook — sistēma pati paziņo citai sistēmai par notikumu.
Mēs API izstrādē bieži izmantojam API Platform ar Symfony, kas no koda automātiski ģenerē dokumentāciju un atbalsta REST un GraphQL.