Iniciar sesiónCrear cuenta gratis

Configuración del agente de IA

Comparte una única URL con Claude Code, Codex u OpenClaw. El agente sigue las instrucciones que recibe, verifica el código de 8 dígitos, guarda su ApiKey de larga duración y empieza a trabajar con tu espacio de trabajo.

El enlace que debes compartir con tu agente

Comparte esta URL exacta:

https://api.expense-budget-tracker.com/v1/

Esa dirección es el documento público de inicio para agentes de IA. Ahí se indica cómo empezar la autenticación, qué llamadas debe hacer después, qué método de autenticación debe usar a continuación y dónde encontrar la especificación pública de la API.

Qué hace el usuario

  1. Abre Claude Code, Codex, OpenClaw u otro agente que pueda hacer solicitudes HTTP.
  2. Indícale al agente que se conecte a Expense Budget Tracker usando https://api.expense-budget-tracker.com/v1/.
  3. Cuando el agente te pida una dirección de correo electrónico, facilítale la que usas en Expense Budget Tracker.
  4. Revisa tu bandeja de entrada para obtener el código de 8 dígitos.
  5. Envíale ese código al agente.
  6. Deja que el agente guarde la ApiKey recibida fuera de la memoria del chat y continúe después con tu tarea de importación, consulta o presupuesto.

Durante el inicio de sesión no hace falta copiar ni pegar claves a mano. El agente establece su propia conexión una vez verificado el código enviado por correo.

Qué hace el agente

La secuencia completa es esta:

  1. GET https://api.expense-budget-tracker.com/v1/
  2. Leer el documento inicial y seguir las acciones devueltas, en lugar de fijar manualmente los pasos siguientes
  3. Enviar por POST el correo del usuario a la bootstrapUrl devuelta
  4. Recibir otpSessionToken y la acción verify_code
  5. Pedirle al usuario el código de 8 dígitos recibido por correo
  6. Enviar por POST code, otpSessionToken y una label de conexión a https://auth.expense-budget-tracker.com/api/agent/verify-code
  7. Recibir una nueva ApiKey
  8. Guardar esa clave fuera de la memoria del chat, preferiblemente como EXPENSE_BUDGET_TRACKER_API_KEY
  9. GET https://api.expense-budget-tracker.com/v1/me con Authorization: ApiKey <key>
  10. GET https://api.expense-budget-tracker.com/v1/workspaces
  11. Si hace falta, crear un espacio de trabajo con POST /v1/workspaces
  12. Guardar un espacio de trabajo predeterminado con POST /v1/workspaces/{workspaceId}/select
  13. Inspeccionar las relaciones permitidas con GET https://api.expense-budget-tracker.com/v1/schema
  14. Ejecutar SQL mediante POST https://api.expense-budget-tracker.com/v1/sql

La selección del espacio de trabajo es explícita, pero el sistema conserva ese estado. El espacio de trabajo elegido se guarda para esa clave después de POST /v1/workspaces/{workspaceId}/select, así que las llamadas posteriores a /v1/sql pueden omitir X-Workspace-Id. Aun así, puedes enviar X-Workspace-Id para sustituir el espacio de trabajo guardado en una petición concreta.

Si el usuario tiene exactamente un espacio de trabajo y la clave todavía no tiene ninguno guardado, el backend lo guarda y lo usa automáticamente.

Qué debe guardar el agente

La clave que devuelve verify-code es de larga duración. No basta con confiar en la memoria del chat.

  • Guárdala en un archivo .env local como EXPENSE_BUDGET_TRACKER_API_KEY='<PASTE_KEY_HERE>' si el usuario autoriza escribir en archivos
  • Si no, expórtala en la shell actual como EXPENSE_BUDGET_TRACKER_API_KEY='<PASTE_KEY_HERE>' y pídele al usuario que la guarde en un lugar persistente

Las peticiones autenticadas usan:

  • Authorization: ApiKey <key>
  • X-Workspace-Id: <workspaceId> solo cuando quieras sustituir el espacio de trabajo guardado o antes de que se haya guardado uno

Si eres un agente de IA

Empieza con:

curl https://api.expense-budget-tracker.com/v1/

Después, sigue las acciones que devuelva el servidor. No supongas una secuencia fija si el documento inicial ya te indica qué hacer.

Después de verify-code, guarda de forma segura la ApiKey devuelta. Luego carga:

  • /v1/me para obtener el contexto de la cuenta
  • /v1/workspaces para ver los espacios de trabajo disponibles
  • /v1/schema para consultar las relaciones y columnas SQL permitidas
  • /v1/openapi.json o /v1/swagger.json para acceder a la especificación pública de la API en un formato legible por máquina

Ejemplos de prompts para personas

Claude Code

Conéctate a Expense Budget Tracker usando https://api.expense-budget-tracker.com/v1/.
Usa el correo de mi cuenta cuando haga falta, pídeme el código de 8 dígitos, guarda la ApiKey recibida fuera de la memoria del chat y después importa mi último extracto bancario desde ~/Downloads.

Codex

Usa https://api.expense-budget-tracker.com/v1/ para conectarte a mi cuenta de Expense Budget Tracker.
Pídeme mi correo electrónico, espera el código enviado por correo, guarda la clave, revisa /schema y después muéstrame mis transacciones más recientes.

OpenClaw

Conéctate a Expense Budget Tracker mediante https://api.expense-budget-tracker.com/v1/.
Después de iniciar sesión, muestra mis espacios de trabajo, guarda uno como predeterminado para esta clave e importa el nuevo CSV que he subido.

Qué puedes hacer después de la configuración

  • Importar extractos bancarios o exportaciones de tarjetas
  • Categorizar transacciones usando tus categorías existentes
  • Verificar saldos de cuentas frente al banco
  • Consultar gastos por categoría, periodo, comercio o cuenta
  • Actualizar partidas presupuestarias para el mes siguiente

Si quieres consultar las rutas de más bajo nivel y los detalles de autenticación, revisa la Referencia de la API.