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
- Guarda el token en memoria (o en un almacén compartido si tienes varios procesos).
- Úsalo en todas las peticiones mientras funcione.
- 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.