Ofertas

Publicar oferta

Pone en cola la publicación de la oferta en un grupo o hilo autorizado.

POST/offers/{id}/publishpublications:write

COMPORTAMIENTO

La solicitud valida la entrada, persiste el comando y devuelve el estado inicial. La ejecución puede continuar en la cola dedicada.

EFECTO

Puede crear trabajos asincrónicos y eventos de webhook después de la confirmación en la base de datos.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorio

segment_idstring · bodySegmento objetivo.opcional

group_idstring · bodyGrupo objetivo.opcional

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

AuthorizationBearer ach_live_...

Acceptapplication/json

Alcancepublications:write

Ejemplo ejecutable

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

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

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

200Operación completada.

400Parámetro, cuerpo o transición no válidos.

401Clave faltante, inválida, caducada o revocada.

402El plan de cuenta no libera esta interfaz.

403A chave precisa do escopo publications:write.

404La característica no existe en esta cuenta.

409El estado actual impide esta operación.

413El cuerpo JSON supera los 128 KB.

429Se ha superado la ventana de 120 solicitudes por minuto.

Publicar oferta

Solicitar

Ejemplo ejecutable

Respuesta y errores

Operaciones relacionadas