Descripción general de la API

La API pública de Bevits permite que integraciones y agentes de IA consulten los datos de una organización. La primera versión es solo de lectura y utiliza una clave API vinculada a la organización.

URL base: https://api.bevits.com/v1

Realiza tu primera solicitud

Crea una clave API

Ve a Configuración → Avanzado → Claves API, crea una clave con acceso de lectura y copia el secreto. Se muestra una sola vez.

Guarda la clave en una variable de entorno

export BEVITS_API_KEY="bvt_live_..."

Consulta la identidad de la conexión

curl --request GET \
  --url https://api.bevits.com/v1/me \
  --header "Authorization: Bearer $BEVITS_API_KEY"

{
  "object": "identity",
  "organization": {
    "id": "org_ckxyz123",
    "name": "Mi tienda"
  },
  "api_key": {
    "id": "bak_ckkey123",
    "name": "Integración",
    "scopes": ["read"]
  },
  "livemode": true
}

Recursos disponibles

Clientes

Busca clientes, datos de contacto, etiquetas, atributos, métricas y compras.

Segmentos

Lista segmentos y consulta sus clientes.

Automatizaciones

Consulta flows y el resumen de sus ejecuciones.

Campañas

Consulta campañas de email y métricas agregadas.

Clientes y compras

Recurso	Endpoints principales
Clientes	`GET /customers`, `GET /customers/{customer_id}`
Compras del cliente	`GET /customers/{customer_id}/purchases`
Segmentos	`GET /segments`, `GET /segments/{segment_id}/customers`
Compras	`GET /purchases`, `GET /purchases/{purchase_id}`
Etiquetas y atributos	`GET /tags`, `GET /attributes`

Marketing y automatización

Recurso	Endpoints principales
Flows	`GET /flows`, `GET /flows/{flow_id}`
Campañas de email	`GET /email-campaigns`, `GET /email-campaigns/{email_campaign_id}`

La clave API determina automáticamente la organización. No envíes un ID de organización en las rutas de esta versión.

Próximos pasos

Autenticación

Crea, almacena y revoca credenciales de forma segura.

Paginación y errores

Comprende cursores, IDs, límites y respuestas de error.

Agentes de IA

Usa la API con Leme, Claude Code, Codex y otros agentes.

Primeros pasos

Fundamentos

Referencia

Descripción general de la API

Realiza tu primera solicitud

Recursos disponibles

Clientes

Segmentos

Automatizaciones

Campañas

Clientes y compras

Marketing y automatización

Próximos pasos

Autenticación

Paginación y errores

Agentes de IA

​Realiza tu primera solicitud

​Recursos disponibles

Clientes

Segmentos

Automatizaciones

Campañas

​Clientes y compras

​Marketing y automatización

​Próximos pasos

Autenticación

Paginación y errores

Agentes de IA

Realiza tu primera solicitud

Recursos disponibles

Clientes y compras

Marketing y automatización

Próximos pasos