Explica principiile și ideologia principală a API-ului RESTful

API RESTful este un stil arhitectural pentru crearea serviciilor web, bazat pe principiile REST (Transferul de Stare Reprezentatională). Idei principale:

• Resurse: Tot ce lucrează cu API-ul este prezentat ca resurse (de exemplu, utilizatori, produse), care sunt identificate prin URI-uri unice.

• Metode HTTP: Pentru interacțiunea cu resursele se folosesc metode HTTP standard:

  • GET — obține date despre resursă;
  • POST — creează o resursă nouă;
  • PUT — actualizează resursa;
  • DELETE — șterge resursa.

• Coduri de stare: Răspunsurile serverului conțin coduri de stare HTTP care informează despre rezultatul operației (de exemplu, 200 OK, 404 Not Found).

• Fără stare (stateless): Fiecare solicitare de la client către server trebuie să conțină toate informațiile necesare pentru procesare, serverul nu păstrează stare între solicitări.

• Cache: Răspunsurile pot fi cache-uite pentru a crește performanța.

• Interfață uniformă: Ușurează interacțiunea și înțelegerea API-ului.

Exemplu de solicitare către API RESTful pentru obținerea listei de utilizatori:

GET /users HTTP/1.1
Host: example.com
Accept: application/json

Răspuns:

[
  {"id": 1, "name": "Иван"},
  {"id": 2, "name": "Мария"}
]

Astfel, API RESTful asigură o interacțiune simplă, ușor de înțeles și standardizată între client și server.