Activar Llave

Visión General

Este endpoint se utiliza para reactivar una llave Bre-B previamente suspendida, restaurando su estado a ACTIVE (Activa).

Detalles del Endpoint

Parámetro

Descripción

Endpoint

https://api.paas-sandbox.co.passportfintech.com/v1/keys/{key_id}/activate

Método

PATCH

Encabezados

Content-Type: application/json, Authorization

Autenticación

Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

  • No requiere cuerpo de solicitud

Ejemplo de Solicitud

curl --location --request PATCH 'https://api.paas-sandbox.co.passportfintech.com/v1/keys/67d9a207-1b46-4961-ad08-24a226e46397/activate' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \

Cuerpo de la Respuesta

  • Código HTTP: 200 OK

  • La respuesta devuelve el estado de la Llave: ACTIVE (Activa)

Ejemplo de Respuesta

{ "created_at": "2025-10-04T00:56:49.752Z", "updated_at": "2025-10-04T01:20:16.602Z", "account_id": "450dfdce-da3d-4261-9226-84913169ab37", "id": "67d9a207-1b46-4961-ad08-24a226e46397", "status": "ACTIVE", "key": { "key_type": "E", "key_value": "78L216DRQG@passportfintech.com" } }

Errores Comunes y Manejo

Código HTTP

Significado

Descripción

400

Bad Request

Campo id faltante o inválido.

401

Unauthorized

Token Bearer ausente o inválido.

403

Forbidden

Alcance insuficiente o falta de permisos para activar la llave.

404

Not Found

No existe una llave con el id proporcionado.

Buenas Prácticas

  • Refresca los tokens OAuth antes de que expiren para evitar fallos de autenticación.

  • Valida los datos de entrada (por ejemplo, que el id sea correcto) antes de enviar la solicitud.

  • Utiliza este endpoint únicamente después de verificar que la llave fue suspendida previamente.

  • Mantén trazabilidad registrando quién y cuándo activó la llave para fines de auditoría.