Claves de API

Overview

Las claves de API permiten que herramientas e integraciones externas lean y escriban datos directamente en sus apps de Bosferi, sin que una persona haya iniciado sesión. Cada clave tiene un alcance limitado a una app y un nivel de permiso específicos, independientes de cualquier otra configuración de acceso de su empresa.

Cómo generar una clave

1. Vaya a Configuración → Claves de API.
2. Haga clic en "Generar nueva clave", asígnele un nombre y elija un nivel de permiso para Calendario (solo lectura, o lectura y edición).
3. Copie la clave que se muestra: es la única vez que aparece.

Scopes

Los permisos de cada clave se definen de forma explícita por app al crearla. No se heredan de ninguna otra configuración de su empresa, incluidos los permisos de acceso a apps de Bosferi AI. A continuación se usa Calendario como ejemplo.

• Ver: la clave puede leer datos (por ejemplo, listar y obtener eventos del calendario), pero no puede crear, actualizar ni eliminar nada.
• Editar: la clave puede leer y escribir (crear, actualizar y eliminar).

Autenticar solicitudes

Envíe su clave como token Bearer en el encabezado Authorization en cada solicitud:

Authorization: Bearer bos_live_k_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API de Calendario

Calendario, como ejemplo. Endpoints:

curl "https://api.bosferi.com/v1/calendar/events?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer bos_live_k_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -X POST "https://api.bosferi.com/v1/calendar/events" \
  -H "Authorization: Bearer bos_live_k_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Team standup",
    "start": "2026-01-15T09:00:00",
    "end": "2026-01-15T09:30:00",
    "allDay": false,
    "color": "primary"
  }'

Límites de solicitudes

Cada clave está limitada a 120 solicitudes por minuto. Las solicitudes que excedan ese límite devuelven un estado 429 con un encabezado Retry-After.

Cómo revocar una clave

Revoque una clave en cualquier momento desde Configuración → Claves de API. La revocación es inmediata: cualquier solicitud que use esa clave se rechaza a partir de ese momento.

Preguntas frecuentes