Aanbiedingen

Aanbieding bijwerken

Werkt alleen de ingediende velden bij.

PATCH/offers/{id}offers: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

urlstring · bodyOriginele HTTPS-URL voor het product.uri · maxLength 2000optioneel

titlestring · bodyPublieke titel van de aanbieding.minLength 3 · maxLength 240optioneel

marketplacestring · bodyBron marktplaats.maxLength 40optioneel

pricenumber · bodyHuidige prijs.optioneel

original_pricenumber · bodyVorige prijs.optioneel

currencystring · bodyISO 4217-valuta.minLength 3 · maxLength 8 · default BRLoptioneel

imagestring · bodyHTTPS-URL van de afbeelding.urioptioneel

storestring · bodyWinkelnaam.optioneel

categorystring · bodyCategorie.optioneel

couponstring · bodyCouponcode.optioneel

copystring · bodyRedactionele tekst van het aanbod.maxLength 6000optioneel

statusstring · bodySamengestelde status.optioneel

AuthorizationBearer ach_live_...

Acceptapplication/json

Reikwijdteoffers:write

Uitvoerbaar voorbeeld

curl

curl -X PATCH 'https://achadu.com/api/v1/offers/resource_id' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "url": "https://example.com/product",
  "title": "Air fryer 5L",
  "marketplace": "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": "off_01J...",
    "marketplace": "amazon",
    "title": "Air fryer 5L",
    "url": "https://example.com/product",
    "price": 329.9,
    "currency": "BRL",
    "review_status": "pending",
    "created_at": "2026-08-31T18:20:00.000Z"
  },
  "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 offers: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.

Aanbieding bijwerken

Verzoek

Uitvoerbaar voorbeeld

Reactie en fouten

Gerelateerde operaties