Skip to main content
POST
Protección de credenciales
cucu vigila, por llave, la lectura de documentos (PDF, XML, ZIP, links temporales), los listados y el detalle de facturas. Si una llave lee de una forma que no es la suya (muchas facturas distintas en una hora contra su propio historial, o muchas búsquedas de ids/CUF que no existen), se frena y, si insiste, se suspende sólo su lectura.
Emitir, anular, /status, by-idempotency-key y el dashboard nunca se frenan. Tu facturación sigue aunque la lectura de documentos esté suspendida.
Una llave frenada o suspendida tampoco puede abrir ni redirigir un canal que exporta datos de compradores: crear o modificar un webhook, rotar su secreto o reenviar una entrega (REST y MCP) responde lo mismo (429 o 403). Listar y ver webhooks, y eliminarlos, siguen permitidos. Los links temporales que emitió una llave suspendida o revocada dejan de bajar en el acto (410 DOCUMENT_LINK_GONE), igual que los de un tenant dado de baja. Esto rige en todos los ambientes.

Avisos

Cuando de verdad se frena o suspende, se avisa por correo al contacto de la empresa y por webhook (security.credential_throttled / security.credential_suspended):
credential_kid es el id público de la llave (nunca la llave). signal: barrido (muchas facturas distintas) o enumeracion (ids/CUF inexistentes). retry_after_seconds sólo en throttled; resume_url sólo en suspended.

Reanudar

  1. Rotá la llave (Rotación). La llave nueva no hereda la suspensión.
  2. Con la llave nueva, reanudá la suspendida:
Es idempotente: resumed: false si no estaba suspendida. Revocar una llave del todo sigue siendo una acción de CUCU (revocarApiKey).