Offerte

Pubblica offerta

Accoda la pubblicazione dell'offerta a un gruppo o thread autorizzato.

POST/offers/{id}/publishpublications:write

COMPORTAMENTO

La richiesta convalida l'input, rende persistente il comando e restituisce lo stato iniziale. L'esecuzione può continuare nella coda dedicata.

EFFETTO

È possibile creare eventi di lavoro asincrono e webhook dopo la conferma nel database.

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

idstring · pathIdentificatore della risorsa.minLength 2 · maxLength 100obbligatorio

segment_idstring · bodySegmento target.facoltativo

group_idstring · bodyGruppo target.facoltativo

with_imageboolean · bodyDeprecated and ignored. Offers are sent as text with a product link preview, never as photo attachments.facoltativo

AuthorizationBearer ach_live_...

Acceptapplication/json

Ambitopublications:write

Esempio eseguibile

curl

curl -X POST 'https://achadu.com/api/v1/offers/resource_id/publish' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "segment_id": "string",
  "group_id": "string",
  "with_image": true
}'

Risposta ed errori

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

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

200Operazione completata.

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 publications: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.

Pubblica offerta

Richiesta

Esempio eseguibile

Risposta ed errori

Operazioni correlate