Pierwsze kroki
Odczyt
Przed edycją odczytaj zasób i przekaż expected_version zgodnie z dokumentacją.
Zapis
Używaj POST do tworzenia obsługiwanych zasobów, PATCH do częściowych zmian i DELETE do obsługiwanych usunięć.
Odpowiedź
Ponowienie zakończonej powodzeniem operacji zwraca zapisany wynik bez ponownego wykonania zmiany.
Nagłówki
- Idempotency-Key
- Każdy zapis zasobu wymaga Idempotency-Key. Generuj jeden klucz na operację logiczną; ponawiając ją, zachowuj ten sam klucz, metodę, cel i treść.
- expected_version
- Zmiany cen mogą dodatkowo wymagać wersji produktu, ceny, cen wariantów lub cennika. Jeśli wersja się zmieni, pobierz dane ponownie i uzgodnij aktualizację, zamiast wymuszać nieaktualny zapis.
Zasady ponawiania
- Użycie klucza dla innego żądania zwraca idempotency.key_reused.
- Przykłady są syntetyczne; przed ich wykonaniem zastąp identyfikatory wartościami pobranymi ze swojego sklepu.