Las claves de API permiten que tu código y tu CI hagan preguntas y lean resultados. Para asistentes de IA como Claude o ChatGPT, conéctate con OAuth: no necesita clave.

Crear una clave

  1. Ve a Desarrolladores en el portal y elige Crear clave.
  2. Ponle el nombre del sitio donde se usará, por ejemplo «CI» o «bot de precios».
  3. Elige sus permisos y un tope de gasto diario.
  4. Confirma que eres tú. La clave empieza por fh_live_ y se muestra una sola vez: cópiala en tu almacén de secretos enseguida.

Solo guardamos un hash de la clave, así que no podemos volver a mostrarla. Si la pierdes, rótala.

Permisos

  • questions:read: resultados y listas.
  • questions:write: estimar, preguntar, cancelar, compartir, subir archivos.
  • templates:read: plantillas de precio fijo.
  • account:read: saldo y movimientos.

Da a cada clave solo lo que necesita.

Rotar y revocar

Rotar crea un secreto nuevo para la misma clave y la misma configuración; el secreto antiguo deja de funcionar. Revocar desactiva la clave para siempre. Ambas acciones surten efecto en menos de un segundo.

Mantén las claves en secreto

Las claves son para servidores. Las peticiones con una clave desde un navegador se rechazan, para que nadie pueda sacar una clave de una página web. Nunca subas claves a un repositorio.

Consulta la documentación para desarrolladores (en inglés) sobre autenticación, errores y límites de peticiones.