Acceso API para personas y agentes

Una clave. Control preciso. Lista para agentes.

Las claves API de Better ics permiten a aplicaciones y agentes generar archivos ICS y gestionar ajustes seleccionados del backend. Cada clave es un token Bearer con permisos explícitos, uso observable y límites controlables.

Credencial Bearer

Authorization

Bearer bics_live_••••••••••••

POST /v1/ics

scope: ics:generate

X-KEY-STATUS

active

X-USAGE

metered

Gobierno de claves

Credenciales que funcionan como infraestructura, no como contraseñas olvidadas.

Crea y gestiona claves independientes para cada integración o agente. Restringe desde dónde funcionan, observa exactamente qué consumen y detén automatizaciones descontroladas antes de tener sorpresas.

Caducidad opcional

Mantén una clave activa indefinidamente o define una fecha de caducidad para agentes, campañas e integraciones temporales.

Restricciones por IP

Limita una clave a direcciones de origen aprobadas cuando las cargas se ejecuten desde infraestructura conocida.

Medición por operación

Controla el uso por clave API y operación en lugar de depender de un total de cuenta opaco.

Un límite. Tres vistas de uso.

Elige un único periodo de límite por clave API: semanal, mensual o total. El uso se sigue midiendo en los tres periodos y se desglosa por operación.

Presupuestos con límites

Un límite. Tres vistas de uso.

Elige un único periodo de límite por clave API: semanal, mensual o total. El uso se sigue midiendo en los tres periodos y se desglosa por operación.

Semanal64%

Seguimiento de uso

Mensual31%

Límite activo

Total12%

Seguimiento de uso

Autoridad explícita

Da a cada clave exactamente el poder necesario.

Los permisos separan la generación de la gestión del backend. Activa solo las capacidades necesarias, con acceso independiente de lectura y escritura para los datos administrables.

01

Generar archivos ICS

ics:generate

Al activarlo, este permiso de ejecución ofrece toda la capacidad de generación ICS. No se divide en modos de lectura y escritura.

Ejecución completa
02

Gestionar bloques de texto dinámicos

placeholders:read · placeholders:write

Permite a un agente consultar los textos reutilizables del backend, modificarlos o ambas cosas.

Lectura / escritura
03

Gestionar ajustes RSVP

rsvp:read · rsvp:write

Expón la configuración RSVP como contexto de solo lectura o permite cambios controlados.

Lectura / escritura

Descubrimiento integrado

/mcp

El camino más corto desde la intención hasta la llamada API correcta.

El endpoint MCP de este sitio da a los agentes compatibles las herramientas y el contexto necesarios para entender Better ics. Dirige un agente a /mcp para que descubra el producto antes de usar la API.

Abrir /mcp

Base de conocimiento

Explorar explicaciones prácticas y conceptos de infraestructura de calendario.

Documentación y guías

Encontrar instrucciones de integración, comportamiento de la API y orientación de implementación.

Preguntas frecuentes

Resolver dudas comunes sobre producto, facturación, seguridad y flujos de trabajo.

Un agente puede aprender antes de actuar.

Mediante /mcp, el agente descubre cómo funciona Better ics. Dale un token Bearer con los permisos necesarios, deja que inspeccione su alcance efectivo y podrá generar ICS o gestionar las funciones web habilitadas expresamente.

  1. 01

    Conectar con /mcp

    El agente descubre las herramientas de Better ics y el contexto autorizado del producto.

  2. 02

    Proporcionar una clave limitada

    Entrega un token Bearer solo con los permisos, acceso de red, caducidad y presupuestos necesarios.

  3. 03

    Inspeccionar permisos

    El agente lee sus permisos y límites efectivos antes de elegir una operación.

  4. 04

    Hacer el trabajo

    Generar archivos ICS o gestionar los bloques de texto y ajustes RSVP habilitados mediante la API.

Haz que la API sea comprensible para el agente que la utiliza.

/mcp es el punto de descubrimiento estable para agentes; las claves limitadas siguen siendo la frontera de cada acción. El agente aprende el sistema, verifica sus permisos y trabaja dentro de los límites definidos.

Trata las claves API como secretos. Da a los agentes solo los permisos y límites imprescindibles y nunca expongas un token Bearer a una herramienta o prompt no fiable.