Consultar Llave
Visión General
Este endpoint permite recuperar los detalles de una Llave Bre-B específica en la API de Passport usando el ID de la llave. La respuesta incluye el valor de la llave, tipo, estado y los detalles de la entidad asociada.
Detalles del Endpoint
Definition | Description |
---|---|
Endpoint | https://api.paas.sandbox.co.passportfintech.com/v1/keys/:key_id |
Method | GET |
Headers | Content-Type: application/json, Authorization |
Authentication | Access Token (Bearer Token) |
Cuerpo de la Solicitud
- No se requiere cuerpo en la solicitud para este endpoint.
Ejemplo de Solicitud
2
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/keys/3184cbfd-73bd-4910-bd03-f8461e724247' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Cuerpo de la Respuesta
- Código HTTP: 200 OK
- La respuesta contiene los detalles de la llave junto con su identificador único.
Ejemplo de Respuesta
11
11
{
"status": "ACTIVE",
"key": {
"key_type": "BCODE",
"key_value": "0016027228"
},
"account_id": "6c23f053-0e1a-46b4-b902-97ba47e351bc",
"created_at": "2025-10-09T10:42:39.710Z",
"updated_at": "2025-10-09T10:42:39.710Z",
"id": "3184cbfd-73bd-4910-bd03-f8461e724247"
}
Errores Comunes y Manejo
Código HTTP | Significado | Descripción |
---|---|---|
400 Bad Request | Datos inválidos | Faltan campos requeridos o contienen valores incorrectos. |
401 Unauthorized | Token expirado | El token de acceso es inválido o ha expirado. |
403 Forbidden | Acceso denegado | La solicitud no está autorizada para recuperar una Llave. |
500 Internal Server Error | Error del servidor | Ocurrió un error inesperado al recuperar la Llave |