Claves y webhooks
Las credenciales y los endpoints que ha emitido este espacio de trabajo.
Herramientas de claves y webhooks
| Herramienta | Qué hace |
|---|---|
| listApiKeys | Todas las claves de API que ha emitido este espacio de trabajo, qué pueden hacer y como qué pueden enviar, en una forma enmascarada que basta para distinguir dos claves y nada más. |
| rotateApiKey | Da un secreto nuevo a una clave, conservando su id, su nombre, sus scopes, su rol y su alcance de envío. No hay ventana de solapamiento, y el secreto nuevo se muestra una sola vez. |
| setApiKeyEnabled | Desactiva una clave, o vuelve a activarla. Esta es la reversible: la clave conserva su secreto, sus scopes, su rol y su alcance de envío. |
| revokeApiKey | Revoca una clave de forma permanente. Una clave revocada no se puede reactivar, rotar ni modificar nunca. |
| setApiKeySendScope | Indica como qué direcciones puede enviar una clave, en dos listas independientes. Lo que pases SUSTITUYE lo que tenía la clave. |
| listWebhooks | Todos los endpoints de webhook que tiene este espacio de trabajo, dónde publican, si están habilitados y qué eventos pidieron. Los secretos de firma no se muestran nunca. |
| listWebhookEvents | Todos los eventos a los que puede suscribirse un endpoint, agrupados por familia, con una línea que dice cuándo se dispara cada uno. |
Un secreto se muestra una vez, cuando la clave se crea o se rota, y después nada lo recupera. rotateApiKey es la única herramienta de aquí que devuelve uno, así que a lo que tenga el secreto antiguo hay que entregarle el reemplazo antes de su siguiente ejecución.
Recurre a setApiKeyEnabled antes que a revokeApiKey. Desactivar una clave es reversible y te dice si algo todavía depende de ella; revocarla es permanente y la única salida es una clave nueva y un secreto nuevo.
Aquí no hay createApiKey ni createWebhook, por la misma razón por la que no hay createRole: emitir una credencial desde dentro de una ventana de chat es un cambio silencioso y amplio que nadie ve después. Ambos están en Ajustes, donde quien lo hace puede ver qué está repartiendo.