# API de plataforma v1 La **API de plataforma v1** está organizada por **módulos**, cada uno con sus operaciones. Con una sola credencial —tu [API Key de cuenta](../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//.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](../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](contacts.md) | Crear, actualizar, listar, importar contactos y notas. | | [Agentes](agents.md) | Listar y configurar agentes, activar/pausar. | | [Llamadas](calls.md) | Listar (nivel cuenta), ver detalle con auditoría y disparar llamadas. | | [Mensajería](messages.md) | Enviar mensajes de WhatsApp (texto o plantilla). | | [Campañas](campaigns.md) | Crear campañas salientes, cargar contactos, activar y ver stats. | | [Créditos](credits.md) | Saldo, movimientos y (partner) asignar/recuperar créditos a clientes. | | [Webhooks](webhooks.md) | Suscribirte a eventos (lead nuevo, ticket, llamada finalizada). |