Kas ir REST API?

REST API ir arhitektūras stils sadalītu sistēmu būvniecībai. REST galvenie principi:

• Statelessness: Katrs pieprasījums no klienta uz serveri jāietver visa nepieciešamā informācija apstrādei. Serveris nesaglabā klienta stāvokli starp pieprasījumiem.
• Client-Server: Skaidrs atbildības sadalījums starp klientu un serveri. Klients sūta pieprasījumus, serveris tos apstrādā.
• Cacheable: Serverim jānorāda, vai atbildes var tikt kešotas klienta vai starpnieka pusē.
• Layered System: Klients nav obligāti tieši jākomunicē ar galapunkta serveri; tas var komunicēt caur starpslāņiem (proksi, slodzes balansētāji).
• Uniform Interface: Vienots un standartizēts veids, kā mijiedarboties starp klientu un serveri. Šis princips ietver:
  • Identification of Resources: Resursi (dati) tiek identificēti ar URL.
  • Manipulation of Resources Through Representations: Klients mijiedarbojas ar resursiem, saņemot to reprezentācijas (piemēram, JSON, XML) un sūtot jaunas reprezentācijas izmaiņām.
  • Self-descriptive Messages: Katrs ziņojums satur pietiekami daudz informācijas, lai saprastu, kā to apstrādāt.
  • HATEOAS (Hypertext As The Engine Of Application State): Resursiem jāietver saites (hipersaites) uz saistītajiem resursiem un pieejamām darbībām.

REST API parasti izmanto standarta HTTP metodes darbībām ar resursiem:

• GET: saņemt resursu vai resursu kolekciju.
• POST: izveidot jaunu resursu.
• PUT: pilnīga esoša resursa atjaunošana.
• PATCH: daļēja esoša resursa atjaunošana.
• DELETE: resursa dzēšana.

Piemērs JSON resursa attēlojumam:

{
  "id": 1, // Identifikators
  "name": "Resource Name", // Resursa nosaukums
  "description": "Detailed description of the resource." // Resursa apraksts
}

REST API testēšana ietver:

• Funkcionalitātes pārbaudi (pareizi atbildes uz pieprasījumiem)
• kļūdu apstrādi
• veiktspēju
• drošību
• dokumentācijas atbilstību.