Claves de API

Las claves son para CI y para clientes que no pueden iniciar sesión a través de un navegador. Cómo crear una, cómo se almacena y cómo revocarla.

No necesitas una clave para Claude, Cursor, Lovable o ChatGPT: inician sesión a través del navegador. Las claves son para scripts, trabajos de CI y clientes sin navegador.

Crear una

Abre “Agents & API” (Agentes y API), escribe una etiqueta (por ejemplo, “Despliegue CI”) y presiona “Create key” (Crear clave). La clave se muestra una vez, así que cópiala ahora. Parece sbe_ak_<id>_<secret>. TileSet solo almacena un hash de la clave secreta, por lo que no puede mostrarla de nuevo. Si la pierdes, creas una nueva.

Usarla

Envíala como Authorization: Bearer <key> en las solicitudes a la API REST o al servidor MCP. Administrar claves, exportar tus datos y eliminar la cuenta requieren iniciar sesión en el panel, no una clave. Mantenla fuera del código del sitio y de cualquier página: el widget de tu página nunca necesita una clave.

Qué puede leer una clave

Una clave configura y ejecuta widgets. Nunca lee tu contenido: para una fuente obtiene recuentos, como cuántos elementos tiene, sus calificaciones de estrellas y cuántos tienen fotos, nunca las publicaciones o reseñas en sí. Si una fuente falla, una clave recibe una frase fija, no la respuesta propia de la plataforma. Para ver un widget, abre https://app.tileset.com/preview/<widgetId>: el widget tal como lo ven los visitantes.

Revocarla

La lista en “Agents & API” muestra la etiqueta de cada clave, una forma enmascarada y cuándo se creó. “Revoke” (Revocar) es un botón de dos pasos y surte efecto de inmediato. Los agentes conectados a través del inicio de sesión del navegador también obtienen una clave, con el nombre de la aplicación (con “OAuth”); revocarla desconecta a ese agente.

Límites

• Hasta 20 claves activas por cuenta, incluyendo las claves de los agentes conectados a través del navegador. Revoca una para agregar otra.
• Las claves que creas no caducan; revocarlas es cómo terminan. Un agente conectado a través del navegador se desconecta después de 90 días sin uso y te pide que lo apruebes de nuevo la próxima vez que lo uses.
• Una clave filtrada puede acceder a tus widgets y fuentes, pero nunca a tus tokens de plataforma. Revócala y crea una nueva.