Coupons

Kortingsbon bijwerken

Updates geldigheid, korting en geschiktheid.

PATCH/coupons/{id}coupons:write

GEDRAG

De wijziging wordt gevalideerd en gehandhaafd in het hoofdaccount voordat er wordt gereageerd. Query's uitvoeren op de geretourneerde bron als de bron van de waarheid.

EFFECT

Het kan de bron wijzigen en de bijbehorende domeingebeurtenis uitzenden.

HERHALING

Bij een netwerkfout bevestigt u de bronstatus voordat u het opnieuw probeert. Alleen 429 en 5xx automatisch opnieuw uitvoeren met backoff en jitter.

Verzoek

idstring · pathResource-ID.minLength 2 · maxLength 100verplicht

marketplacestring · bodyMarktplaats.optioneel

codestring · bodyCouponcode.optioneel

descriptionstring · bodyBeschrijving.optioneel

valuestring · bodyWaarde gepresenteerd.optioneel

minimumnumber · bodyMinimale bestelling.optioneel

valid_untilstring · bodyISO-geldigheid.optioneel

typestring · bodyCoupontype.optioneel

discountnumber · bodyPercentage of kortingsbedrag.optioneel

capnumber · bodyKortingsplafond.optioneel

categoriesarray · bodyGeschikte categorieën.optioneel

verifiedboolean · bodyMarkeer de kortingsbon als geverifieerd.optioneel

activeboolean · bodyActiveer of archiveer de kortingsbon.optioneel

AuthorizationBearer ach_live_...

Acceptapplication/json

Reikwijdtecoupons:write

Uitvoerbaar voorbeeld

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"
}'

Reactie en fouten

Elk antwoord bevat request_id. Lijsten voegen paginering toe; veranderlijke bronnen retourneren de persistente status na de bewerking.

200 application/json

{
  "data": {
    "id": "cpn_01J...",
    "marketplace": "amazon",
    "code": "HOME10",
    "discount": 10,
    "verified": 1,
    "active": 1
  },
  "request_id": "req_01J..."
}

200Operatie voltooid.

400Ongeldige parameter, hoofdtekst of overgang.

401Ontbrekende, ongeldige, verlopen of ingetrokken sleutel.

402Het accountplan geeft deze interface niet vrij.

403A chave precisa do escopo coupons:write.

404Functie bestaat niet in dit account.

409De huidige status verhindert deze bewerking.

413De JSON-hoofdtekst is groter dan 128 KB.

429Het venster van 120 verzoeken per minuut is overschreden.

Kortingsbon bijwerken

Verzoek

Uitvoerbaar voorbeeld

Reactie en fouten

Gerelateerde operaties