API pública

Descuentazos permite publicar ofertas programáticamente. El flujo tiene dos pasos: canjeás tu API key por un token corto y usás ese token contra la API de ofertas.

La especificación completa está en openapi.yaml. Tu API key se crea desde la app: Perfil → Ajustes → API keys. Guardala: se muestra una sola vez.

1. Canjeá tu API key por un token

Los tokens duran 1 hora y llevan el scope deals:write.

curl -X POST https://auth.descuentazos.example/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "dk_live_TU_API_KEY"}'

# → {"accessToken": "eyJ...", "expiresIn": 3600, "tokenType": "api_key", "scopes": ["deals:write"]}

2. Publicá una oferta

curl -X POST https://api.descuentazos.example/v1/deals \
  -H "Authorization: Bearer eyJ..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.fravega.com/p/heladera-x",
    "title": "Heladera X 300L a mitad de precio",
    "description": "Precio histórico, envío gratis a todo el país",
    "price": 499999,
    "originalPrice": 999999,
    "categorySlug": "electrodomesticos",
    "dealType": "product",
    "store": "Frávega"
  }'

Reglas

Título: 8–140 caracteres. Descripción: mínimo 5 palabras.
categorySlug: consultá GET /v1/categories.
dealType: product (producto con precio) o promo (promo bancaria/billetera, usá discountLabel).
Límite de publicación diario por usuario. URLs duplicadas activas devuelven 409.
Las ofertas creadas por API quedan marcadas con source: api.

Errores

Todas las respuestas de error usan el mismo envelope: {"error": {"code": "...", "message": "..."}}