Eliminar Llave

Visión General

Este endpoint permite eliminar una Llave Bre-B previamente creada. Al eliminar una llave, se actualiza el nodo federado y se sincroniza con el nodo centralizado administrado por el Banco de la República.

Información

Una vez canceladas, las llaves no pueden reactivarse. Sin embargo, es posible crearlas nuevamente.

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/keys/:key_id
Método	DELETE
Encabezados	Authorization
Autenticación	Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

No se requiere cuerpo en la solicitud para este endpoint.

Ejemplo de Solicitud

curl --location --request DELETE 'https://api.paas.sandbox.co.passportfintech.com/v1/keys/da096c03-890e-4dc4-bffa-e332fa69e3e1' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data ''

Cuerpo de la Respuesta

Código HTTP: 204 No Content
No se devuelve cuerpo de respuesta.

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 no es inválido o ha expirado.
403 Forbidden	Acceso denegado	La solicitud no está autorizada para eliminar una Llave.
500 Internal Server Error	Error del servidor	Ocurrió un error inesperado al eliminar la Llave.

Mejores Prácticas

Incluye siempre el identificador de la llave en el path parameter.
Trata el 204 No Content como confirmación de éxito.
Revoca las llaves de inmediato si sospechas compromiso o uso indebido.

Última actualización el