Kupony
Zaktualizuj kupon
Aktualizuje ważność, rabat i kwalifikowalność.
PATCH
/coupons/{id}coupons:writeZACHOWANIE
Zmiana zostanie zweryfikowana i utrwalona na koncie kluczowym przed udzieleniem odpowiedzi. Zapytaj zwrócony zasób jako źródło prawdy.
EFEKT
Może zmienić zasób i wyemitować odpowiednie zdarzenie domeny.
POWTÓRKA
W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.
Żądanie
idstring · pathIdentyfikator zasobu.minLength 2 · maxLength 100obowiązkowemarketplacestring · bodyRynek.opcjonalnecodestring · bodyKod kuponu.opcjonalnedescriptionstring · bodyOpis.opcjonalnevaluestring · bodyPrezentowana wartość.opcjonalneminimumnumber · bodyMinimalne zamówienie.opcjonalnevalid_untilstring · bodyWażność ISO.opcjonalnetypestring · bodyTyp kuponu.opcjonalnediscountnumber · bodyProcent lub kwota rabatu.opcjonalnecapnumber · bodyPułap rabatowy.opcjonalnecategoriesarray · bodyKwalifikujące się kategorie.opcjonalneverifiedboolean · bodyOznacz kupon jako zweryfikowany.opcjonalneactiveboolean · bodyAktywuj lub zarchiwizuj kupon.opcjonalneAuthorization
Bearer ach_live_...Accept
application/jsonZakres
coupons:writePrzykład wykonywalny
curl
curl -X PATCH 'https://achadu.com/api/v1/coupons/resource_id' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{
"marketplace": "string",
"code": "string",
"description": "string"
}'Odpowiedź i błędy
Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.
200 application/json
{
"data": {
"id": "cpn_01J...",
"marketplace": "amazon",
"code": "HOME10",
"discount": 10,
"verified": 1,
"active": 1
},
"request_id": "req_01J..."
}200Operacja zakończona.400Nieprawidłowy parametr, treść lub przejście.401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.402Plan konta nie udostępnia tego interfejsu.403A chave precisa do escopo coupons:write.404Funkcja nie istnieje na tym koncie.409Obecny stan uniemożliwia tę operację.413Treść JSON przekracza 128 KB.429Przekroczono okno 120 żądań na minutę.