Offerte

Crea offerta

Crea un'offerta in sospeso senza pubblicarla.

POST/offersoffers:write

COMPORTAMENTO

La modifica viene convalidata e mantenuta nell'account chiave prima di rispondere. Interroga la risorsa restituita come fonte di verità.

EFFETTO

Può modificare la risorsa ed emettere l'evento di dominio corrispondente.

RIPETIZIONE

In caso di errore di rete, verificare lo stato della risorsa prima di riprovare. Ripristina automaticamente solo 429 e 5xx con backoff e jitter.

Richiesta

urlstring · bodyURL HTTPS originale per il prodotto.uri · maxLength 2000obbligatorio

titlestring · bodyTitolo pubblico dell'offerta.minLength 3 · maxLength 240obbligatorio

marketplacestring · bodyMercato di origine.maxLength 40facoltativo

pricenumber · bodyPrezzo attuale.facoltativo

original_pricenumber · bodyPrezzo precedente.facoltativo

currencystring · bodyValuta ISO 4217.minLength 3 · maxLength 8 · default BRLfacoltativo

imagestring · bodyURL HTTPS dell'immagine.urifacoltativo

storestring · bodyNome del negozio.facoltativo

categorystring · bodyCategoria.facoltativo

couponstring · bodyCodice coupon.facoltativo

copystring · bodyTesto editoriale dell'offerta.maxLength 6000facoltativo

statusstring · bodyStato curato.facoltativo

AuthorizationBearer ach_live_...

Acceptapplication/json

Ambitooffers:write

Esempio eseguibile

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

Risposta ed errori

Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.

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

201Risorsa creata e persistente.

400Parametro, corpo o transizione non validi.

401Chiave mancante, non valida, scaduta o revocata.

402Il piano dell'account non rilascia questa interfaccia.

403A chave precisa do escopo offers:write.

404La funzionalità non esiste in questo account.

409Lo stato attuale impedisce questa operazione.

413Il corpo JSON supera i 128 KB.

429La finestra di 120 richieste al minuto è stata superata.

Crea offerta

Richiesta

Esempio eseguibile

Risposta ed errori

Operazioni correlate