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

# Referencia del SDK

> Configuración, entornos y paginación

## Setup

```typescript theme={null}
import { Commet } from '@commet/node'

const commet = new Commet({
  apiKey: process.env.COMMET_API_KEY!,
})
```

Obtén tu API key desde el dashboard en **Settings → API Keys**.

El paquete instalado incluye documentación para agentes que coincide con su versión en `node_modules/@commet/node/docs/README.md`. Ejecutá `commet doctor --output agent` para revisar el SDK y la configuración local sin modificar archivos ni conectarte con Commet.

## Opciones

| Opción | Tipo | Default | Descripción |
| - | - | - | - |
| `apiKey` | string | requerido | Tu API key de acceso completo (`ck_`) o restringido (`rk_`). La org dueña de la key decide si las llamadas corren contra datos sandbox o live. |
| `apiVersion` | string | versión con la que se compiló la release del SDK | Pin de versión de API, enviado como header `Commet-Version` en cada request. Mira [Versionado de API](/docs/es/api-versioning). |
| `debug` | boolean | `false` | Loguea requests/responses |
| `timeout` | number | `30000` | Timeout del request (ms) |
| `retries` | number | `3` | Cantidad máxima de reintentos |
| `telemetry` | boolean | `true` | Envía info anónima del cliente (versión del SDK, runtime, plataforma) con los requests. Ponlo en `false` para desactivarlo. |

## Sandbox vs live

Hay un único host de API, `commet.co`. Usa una API key creada en una organización sandbox mientras integras; cámbiala por una key de organización live cuando pases a producción. No hay cambios de código más allá de la variable de entorno.

## Modo debug

Ver todos los requests y responses:

```typescript theme={null}
const commet = new Commet({
  apiKey: process.env.COMMET_API_KEY!,
  debug: true,
})

// [Commet SDK] POST https://commet.co/api/v1/customers
// [Commet SDK] Response status: 200 OK
```

## Paginación

Los endpoints de listado usan paginación basada en cursor.

```typescript theme={null}
const page = await commet.customers.list({ limit: 25 })

if (page.hasMore) {
  const nextPage = await commet.customers.list({
    limit: 25,
    cursor: page.nextCursor,
  })
}
```

| Parámetro | Tipo | Default | Descripción |
| - | - | - | - |
| `limit` | number | 25 | Items por página (máx 100) |
| `cursor` | string | - | Cursor del response anterior |


## Related topics

- [Integrar con Flask](/docs/es/integrate-with-flask.md)
- [Integrar con Go](/docs/es/integrate-with-go.md)
- [Integrar con Hono](/docs/es/integrate-with-hono.md)
- [Integrar con Django](/docs/es/integrate-with-django.md)
- [Integrar con Encore](/docs/es/integrate-with-encore.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.