Este endpoint se utiliza para obtener un token de acceso usando credenciales de cliente para la autenticación de la API.
Cuerpo de la Solicitud
El cuerpo de la solicitud debe contener los siguientes campos requeridos:
El tipo de concesión OAuth 2.0. Debe establecerse en client_credentials.
Tu identificador de cliente proporcionado por Docta.
Tu secreto de cliente proporcionado por Docta.
Ejemplo de Solicitud
curl -X POST https://api.doctacapital.com.ar/api/v1/auth/token/ \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "your-client-id",
"client_secret": "your-client-secret",
"scope": "bonds:read cedears:read stocks:read"
}'
Respuesta Exitosa
El token de acceso a ser usado para solicitudes posteriores de la API.
El tipo de token. Será Bearer.
El número de segundos hasta que el token expire.
El alcance de acceso otorgado por este token.
El plan asociado al token. Puede ser basic, professional o enterprise.
Ejemplo de Respuesta Exitosa
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJwcm9kLWJhc3Rpb24tMDAxIiwiY2xpZW50X2lkIjoicHJvZC1iYXN0aW9uLTAwMSIsInNjb3BlcyI6WyJtYXJrZXRfZGF0YTpyZWFkIl0sInBsYW4iOiJlbnRlcnByaXNlIiwidG9rZW5fdHlwZSI6ImJlYXJlciIsImV4cCI6MTc1NzQ1Njg5OSwiaWF0IjoxNzU3NDUzMjk5fQ.zbvaoJLRwXFgW0aYG3DiZQM3p_4BZ3SNWj1mZEtN9wU",
"token_type": "bearer",
"expires_in": 3600,
"scope": "bonds:read cedears:read stocks:read",
"plan": "enterprise"
}
Respuesta de Error
El identificador del tipo de error.
Una breve descripción del error.
El código de estado HTTP.
Una descripción detallada del error.
Un identificador único para rastrear esta solicitud de error.
Ejemplo de Respuesta de Error
{
"type": "/errors/authentication-required",
"title": "Invalid client credentials",
"status": 401,
"detail": "Invalid client credentials",
"correlation_id": "2eb07802-94de-468a-b70f-75a49f3e9516"
}
Credenciales de cliente para autenticación
grant_type
enum<string>
default:client_credentials
required
El tipo de concesión OAuth 2.0. Debe establecerse en client_credentials
Available options:
client_credentials
Tu identificador de cliente proporcionado por Docta
Tu secreto de cliente proporcionado por Docta
Token de acceso obtenido exitosamente
El token de acceso a ser usado para solicitudes posteriores de la API
El tipo de token. Será Bearer
Available options:
Bearer
El número de segundos hasta que el token expire
El alcance de acceso otorgado por este token