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

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

{ "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