Docs · Referencia

Tokens de acceso

Cambia las credenciales del cliente por el token de corta duración que necesitan todas las demás llamadas.

Cambiar las credenciales del cliente por un token de acceso

POST/v1/oauth/token

Envía tu client_id y tu client_secret con HTTP Basic (recomendado) o como campos de formulario, con grant_type en client_credentials. El token lleva los scopes fijados en el cliente; el campo scope está reservado y se ignora. Cualquier problema con el cliente devuelve el mismo error invalid_client. Las respuestas nunca se guardan en caché.

Autenticación

HTTP Basic con tu client_id y tu client_secret, o esos mismos dos valores como campos de formulario.

Cuerpo de la solicitud · application/x-www-form-urlencoded

grant_typestringobligatorio

Siempre client_credentials

Uno de client_credentials

scopestring

Reservado y se ignora: el token lleva los scopes fijos del cliente

client_idstring

Solo si no usas HTTP Basic

client_secretstring

Solo si no usas HTTP Basic

Respuesta · TokenResponse

access_tokenstringobligatorio

Token bearer opaco. No es un JWT: no lo analices

token_typestringobligatorio

Siempre Bearer

Uno de Bearer

expires_inintegerobligatorio

Segundos hasta que el token vence

scopestringobligatorio

Los scopes fijados en el cliente

Respuestas

200Token emitido
400La solicitud está mal formada o el grant type no es client_credentials
401invalid_client: no se pudo autenticar al cliente
413El cuerpo supera el límite de tamaño. No se puede reintentar
415La operación no acepta el tipo de contenido del cuerpo. No se puede reintentar
429Demasiadas solicitudes. Espera lo que indique Retry-After
500Algo falló de forma inesperada del lado de Novo. No se puede reintentar: menciona request_id a soporte
503Algo de lo que depende la respuesta no está disponible. Reintenta después de Retry-After

Solicitud

curl -X POST "https://$NOVO_API_HOST/v1/oauth/token" \
  -u "nvo_client_example:$CLIENT_SECRET" \
  -d "grant_type=client_credentials"

Respuesta · 200

{
  "access_token": "nvo_at_example_opaque_token",
  "token_type": "Bearer",
  "expires_in": 900,
  "scope": "accounts:read transactions:read"
}

Previsto para tokens de acceso

Limitar una clave a las herramientas y equipos que aprobaste

Todavía no está disponible, y no se publica ningún endpoint para esto. Aparecerán aquí cuando el contrato los defina. Todo lo marcado como “requiere tu aprobación” espera a que el titular de la cuenta lo apruebe en su teléfono, cada vez. Dinos qué necesitas primero cuando pidas tu lugar.