> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/api-de-la-plataforma/v1.md).

# Introducción

La **API de plataforma v1** está organizada por **módulos**, cada uno con sus operaciones. Con una sola credencial —tu [API Key de cuenta](/anunzi-ia-documentation/api-de-la-plataforma/api-keys.md)— trabajás con contactos, agentes, llamadas, mensajería, campañas, créditos y webhooks.

***

## Base URL y versión

```
https://panel.anunzi.net/api/v1/<módulo>/<acción>.php
```

La versión `v1` garantiza estabilidad: si en el futuro cambian los contratos, saldrá una `v2` sin romper tus integraciones.

## Autenticación

Todas las solicitudes llevan tu API Key de cuenta en el encabezado:

```
Authorization: Bearer anz_live_TU_API_KEY
```

Cada operación queda **limitada automáticamente a tu cuenta** (y a la de tus clientes, si sos partner). Ver [API Keys de cuenta](/anunzi-ia-documentation/api-de-la-plataforma/api-keys.md).

## Formato de respuesta

Todas las respuestas son JSON con esta forma:

```json
{ "ok": true, "data": … , "paging": { "limit": 50, "offset": 0, "total": 120 } }
```

En caso de error:

```json
{ "ok": false, "error": "Mensaje legible", "code": "codigo_maquina" }
```

El **código HTTP** refleja el resultado real: `200` OK · `400` datos inválidos · `401` sin credencial · `402` sin créditos · `403` fuera de alcance · `404` no encontrado · `429` límite de tasa · `500` error del servidor.

## Paginación

Los listados aceptan `?limit=` (por defecto 50, máx. 200) y `?offset=`. La respuesta incluye `paging` con el total.

***

## Módulos

| Módulo                                                                  | Para qué                                                              |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [Contactos](/anunzi-ia-documentation/api-de-la-plataforma/contacts.md)  | Crear, actualizar, listar, importar contactos y notas.                |
| [Agentes](/anunzi-ia-documentation/api-de-la-plataforma/agents.md)      | Listar y configurar agentes, activar/pausar.                          |
| [Llamadas](/anunzi-ia-documentation/api-de-la-plataforma/calls.md)      | Listar (nivel cuenta), ver detalle con auditoría y disparar llamadas. |
| [Mensajería](/anunzi-ia-documentation/api-de-la-plataforma/messages.md) | Enviar mensajes de WhatsApp (texto o plantilla).                      |
| [Campañas](/anunzi-ia-documentation/api-de-la-plataforma/campaigns.md)  | Crear campañas salientes, cargar contactos, activar y ver stats.      |
| [Créditos](/anunzi-ia-documentation/api-de-la-plataforma/credits.md)    | Saldo, movimientos y (partner) asignar/recuperar créditos a clientes. |
| [Webhooks](/anunzi-ia-documentation/api-de-la-plataforma/webhooks.md)   | Suscribirte a eventos (lead nuevo, ticket, llamada finalizada).       |