Autenticación y claves
Cómo enviar tu clave API, cómo se guardan las claves y qué ocurre cuando se revoca una clave o termina un plan.
Cada solicitud lleva tu clave como token Bearer, tanto en REST como en MCP:
Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000Gestionar las claves
- Crea y revoca claves en Claves API. Puedes tener hasta 20 claves activas, así que usa una por aplicación.
- Una clave se muestra una sola vez, al crearla. Solo guardamos un hash y no podemos volver a mostrarla: si la pierdes, revócala y crea otra.
- La página muestra cuándo se usó cada clave por última vez y sus solicitudes al día.
Mantener segura una clave
- Guarda las claves en tu servidor o en la configuración de tu cliente MCP. Nunca pongas una en una página web o en un repositorio público: la API REST no permite llamadas desde navegadores en otros sitios.
- Nunca pongas una clave en una URL. Solo se lee la cabecera
Authorization. - Si una clave puede haberse filtrado, revócala. Deja de funcionar en la siguiente solicitud.
Cuándo se interrumpe el acceso
Las claves se comprueban en cada solicitud, sin nada en caché:
- Clave revocada:
401 invalid_api_key. - Plan sin la API, también cuando termina una suscripción:
403 plan_without_api. Tus claves vuelven a funcionar si te suscribes de nuevo. - Cuenta suspendida:
403 suspended.
Versiones
La versión está en la ruta, /api/v1, y cada respuesta lleva X-API-Version: 1. Dentro de v1 solo añadimos cosas, como campos y endpoints nuevos, así que ignora los campos que no conozcas. Los cambios aparecen en el registro de cambios.