După ce standard ați descris API-ul REST? Cum faceți ca un POST să fie idempotent?

Adesea, pentru descrierea API-ului REST, se utilizează standardul OpenAPI (anterior cunoscut sub numele de Swagger). Acesta permite formalizarea descrierii API-ului în format YAML sau JSON, ceea ce facilitează generarea de documentație, SDK-uri pentru client și testare.

Pentru a face un POST idempotent, se pot folosi mai multe abordări:

• Implementați un identificator unic al solicitării (de exemplu, Idempotency-Key) în anteturi. Serverul, primind o solicitare repetată cu aceeași cheie, nu va crea o copie, ci va returna rezultatul primei solicitări.
• Utilizați PUT în loc de POST, deoarece PUT este idempotent în mod implicit (actualizează o resursă la un URI cunoscut).

Exemplu cu Idempotency-Key:

POST /orders HTTP/1.1
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json

{ "product_id": 42, "quantity": 1 }

Dacă serverul a primit anterior această solicitare cu această cheie, va returna același răspuns fără a crea o comandă nouă.