Angebote

Angebot erstellen

Erstellt ein ausstehendes Angebot, ohne es zu veröffentlichen.

POST/offersoffers:write

VERHALTEN

Die Änderung wird validiert und im Schlüsselkonto gespeichert, bevor reagiert wird. Fragen Sie die zurückgegebene Ressource als Quelle der Wahrheit ab.

WIRKUNG

Es kann die Ressource ändern und das entsprechende Domänenereignis ausgeben.

WIEDERHOLUNG

Bestätigen Sie bei einem Netzwerkfehler den Ressourcenstatus, bevor Sie es erneut versuchen. Nur 429 und 5xx mit Backoff und Jitter automatisch wiederholen.

Anfrage

urlstring · bodyUrsprüngliche HTTPS-URL für das Produkt.uri · maxLength 2000obligatorisch

titlestring · bodyÖffentlicher Titel des Angebots.minLength 3 · maxLength 240obligatorisch

marketplacestring · bodyQuellmarktplatz.maxLength 40optional

pricenumber · bodyAktueller Preis.optional

original_pricenumber · bodyVorheriger Preis.optional

currencystring · bodyISO 4217-Währung.minLength 3 · maxLength 8 · default BRLoptional

imagestring · bodyHTTPS-URL des Bildes.urioptional

storestring · bodyShopname.optional

categorystring · bodyKategorie.optional

couponstring · bodyGutscheincode.optional

copystring · bodyRedaktioneller Text des Angebots.maxLength 6000optional

statusstring · bodyKuratierter Status.optional

AuthorizationBearer ach_live_...

Acceptapplication/json

Umfangoffers:write

Ausführbares Beispiel

curl

curl -X POST 'https://achadu.com/api/v1/offers' \
  -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",
  "price": 329.9,
  "original_price": 329.9
}'

Reaktion und Fehler

Jede Antwort enthält request_id. Listen fügen Paginierung hinzu; Veränderbare Ressourcen geben nach der Operation den persistenten Zustand zurück.

201 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"
  },
  "created": true,
  "request_id": "req_01J..."
}

201Ressource erstellt und beibehalten.

400Ungültiger Parameter, Körper oder Übergang.

401Fehlender, ungültiger, abgelaufener oder widerrufener Schlüssel.

402Der Account-Plan gibt diese Schnittstelle nicht frei.

403A chave precisa do escopo offers:write.

404Die Funktion ist in diesem Konto nicht vorhanden.

409Der aktuelle Status verhindert diesen Vorgang.

413Der JSON-Körper ist größer als 128 KB.

429Das Zeitfenster von 120 Anfragen pro Minute wurde überschritten.

Angebot erstellen

Anfrage

Ausführbares Beispiel

Reaktion und Fehler

Verwandte Operationen