Ofertas

Oferta de actualización

Actualiza solo los campos enviados.

PATCH/offers/{id}offers:write

COMPORTAMIENTO

El cambio se valida y persiste en la cuenta clave antes de responder. Consulta el recurso devuelto como fuente de verdad.

EFECTO

Puede cambiar el recurso y emitir el evento de dominio correspondiente.

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

urlstring · bodyURL HTTPS original del producto.uri · maxLength 2000opcional

titlestring · bodyTítulo público de la oferta.minLength 3 · maxLength 240opcional

marketplacestring · bodyMercado de origen.maxLength 40opcional

pricenumber · bodyPrecio actual.opcional

original_pricenumber · bodyPrecio anterior.opcional

currencystring · bodyMoneda ISO 4217.minLength 3 · maxLength 8 · default BRLopcional

imagestring · bodyURL HTTPS de la imagen.uriopcional

storestring · bodyNombre de la tienda.opcional

categorystring · bodyCategoría.opcional

couponstring · bodyCódigo de cupón.opcional

copystring · bodyTexto editorial de la oferta.maxLength 6000opcional

statusstring · bodyEstado curado.opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Alcanceoffers:write

Ejemplo ejecutable

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

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

Oferta de actualización

Solicitar

Ejemplo ejecutable

Respuesta y errores

Operaciones relacionadas