Empezar

Autenticación

Obtén un token con tu llave y tu secreto, y reutilízalo hasta que venza.
Cada inicio de sesión revoca los tokens anteriores de la llave. Reutiliza el token hasta que venza; no inicies sesión antes de cada petición ni en paralelo desde varios procesos con la misma llave, o tus propias peticiones en curso empezarán a fallar con 401.

Obtener el token

DisponiblePOST /partners/v1/auth/login Ver operación en la Referencia →

Envía tu llave y tu secreto a POST /partners/v1/auth/login:

Terminal
curl -X POST "$OPENBOX_API_URL/partners/v1/auth/login" \
  -H 'Content-Type: application/json' \
  -d '{"key":"<TU_LLAVE>","secret":"<TU_SECRETO>"}'

La respuesta trae el token de acceso:

{
  "data": {
    "access_token": "<TOKEN>"
  }
}

Si la llave o el secreto no son válidos, la respuesta es 401 con el mensaje API key y/o secret no valida.. Si la llave no tiene perfil o empresa asignada, es 403: pide al equipo de Openbox Cloud que revise el aprovisionamiento.

Usar el token

Envía el token en la cabecera Authorization de cada petición:

Terminal
curl "$OPENBOX_API_URL/partners/v1/invoices/<ID_DE_LA_VENTA>" \
  -H 'Authorization: Bearer <TOKEN>'

Cuándo volver a iniciar sesión

  1. Guarda el token en memoria (o en un almacén compartido si tienes varios procesos).
  2. Úsalo en todas las peticiones mientras funcione.
  3. Solo cuando una petición responda 401, inicia sesión una vez, reemplaza el token y repite esa petición.

Nunca pongas la llave ni el secreto en el código de un navegador o una app móvil: la integración corre en tu servidor.

Copyright © 2026