Dokumentacja dla deweloperówPierwsze kroki

Idempotencja

Ponawiaj POST /v1/pack bez tworzenia drugiego zadania.

Wysyłaj Idempotency-Key z POST /v1/pack (lub POST /v1/projects/{id}/pack). Gdy ponowisz zapytanie z tym samym kluczem, dostaniesz to samo zadanie, rozliczone tylko raz.

Bash

curl -X POST https://runner.cargoduo.com/v1/pack \
  -H "Authorization: Bearer $CARGODUO_API_KEY" \
  -H "Idempotency-Key: order-1042-v1" \
  -H "Content-Type: application/json" \
  -d @request.json

Reguła	Szczegóły
Okno	24 h, na organizację
Klucz	Dowolny ciąg znaków, maks. 128 zn.: UUID lub ID Twojego zamówienia
Powtórzenie	Pierwotne zadanie z `Idempotent-Replayed: true`. `200` po jego zakończeniu, `202` wcześniej
Za długi	`400 idempotency_key_invalid`

Jeden klucz na jedno logiczne zapytanie. Zmieniona treść wymaga nowego klucza.

Powiązane

Utwórz zadanie załadunkuWaliduje zapytanie, rezerwuje z Twoich kredytów maksymalną możliwą cenę i dodaje zadanie do kolejki.BłędyJedna struktura błędu, stałe kody, jasne zasady ponawiania.

Powiązane#

Powiązane