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.
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
3
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 Contentcomo confirmación de éxito. - Revoca las llaves de inmediato si sospechas compromiso o uso indebido.