> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bevits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general de la API

> Consulta los datos de CRM y automatización de tu organización mediante la API de Bevits.

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.

<Info>
  **URL base:** `https://api.bevits.com/v1`
</Info>

## Realiza tu primera solicitud

<Steps>
  <Step title="Crea una clave API">
    Ve a [Configuración → Avanzado → Claves API](https://app.bevits.com/settings/api-keys),
    crea una clave con acceso de lectura y copia el secreto. Se muestra una sola
    vez.
  </Step>

  <Step title="Guarda la clave en una variable de entorno">
    ```bash theme={null}
    export BEVITS_API_KEY="bvt_live_..."
    ```
  </Step>

  <Step title="Consulta la identidad de la conexión">
    ```bash theme={null}
    curl --request GET \
      --url https://api.bevits.com/v1/me \
      --header "Authorization: Bearer $BEVITS_API_KEY"
    ```

    ```json theme={null}
    {
      "object": "identity",
      "organization": {
        "id": "org_ckxyz123",
        "name": "Mi tienda"
      },
      "api_key": {
        "id": "bak_ckkey123",
        "name": "Integración",
        "scopes": ["read"]
      },
      "livemode": true
    }
    ```
  </Step>
</Steps>

## Recursos disponibles

<CardGroup cols={2}>
  <Card title="Clientes" icon="users" href="/es/api-reference/overview#clientes-y-compras">
    Busca clientes, datos de contacto, etiquetas, atributos, métricas y compras.
  </Card>

  <Card title="Segmentos" icon="filter" href="/es/api-reference/overview#clientes-y-compras">
    Lista segmentos y consulta sus clientes.
  </Card>

  <Card title="Automatizaciones" icon="diagram-project" href="/es/api-reference/overview#marketing-y-automatización">
    Consulta flows y el resumen de sus ejecuciones.
  </Card>

  <Card title="Campañas" icon="envelope" href="/es/api-reference/overview#marketing-y-automatización">
    Consulta campañas de email y métricas agregadas.
  </Card>
</CardGroup>

### 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}` |

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

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/es/api-reference/authentication">
    Crea, almacena y revoca credenciales de forma segura.
  </Card>

  <Card title="Paginación y errores" icon="code" href="/es/api-reference/fundamentals">
    Comprende cursores, IDs, límites y respuestas de error.
  </Card>

  <Card title="Agentes de IA" icon="sparkles" href="/es/api-reference/ai-agents">
    Usa la API con Leme, Claude Code, Codex y otros agentes.
  </Card>
</CardGroup>