Para desarrolladores
OpenAPI y colección Postman de la API de WhatsApp
Los 153 endpoints de la API en un archivo OpenAPI 3.1 y en una colección Postman v2.1, en tres idiomas. Los archivos se generan de la misma fuente que la referencia en /docs/referencia y se contrastan con la especificación de producción.
153 endpoints en 17 categorías
Descargas
Especificación en vivo
La especificación que sirve la propia API (en portugués) está en https://api.zapzapapi.com/openapi.json. Los archivos de esta página traen los mismos 153 endpoints, con textos en tres idiomas.
Cómo importar
- Postman: Import, luego File (o Link, pegando la URL del archivo). La colección trae las variables baseUrl, apiKey, apiSecret e instanceId; complétalas en la pestaña Variables.
- Insomnia, Bruno y Hoppscotch: importa el archivo OpenAPI o la colección Postman desde el menú de importación.
- Cliente tipado: genera un SDK con OpenAPI Generator, por ejemplo npx @openapitools/openapi-generator-cli generate -i zapzap-openapi.es.json -g typescript-fetch -o ./zapzap-client.
Autenticación
Cada solicitud lleva los encabezados x-api-key y x-api-secret, que copias en Configuración y API del panel. La base es https://api.zapzapapi.com/api/v1.
Ejemplo: enviar un texto
curl -X POST "https://api.zapzapapi.com/api/v1/{instanceId}/send/text" \
-H "x-api-key: SUA_CHAVE" \
-H "x-api-secret: SEU_SEGREDO" \
-H "Content-Type: application/json" \
-d '{"number":"5511999999999","text":"Hello!"}'Cómo se generan estos archivos
Un script (scripts/gerar-openapi.mjs) lee la referencia de la API del sitio y arma el OpenAPI y la colección Postman. Falla si el conteo de operaciones difiere de la fuente o entre idiomas, y enmascara cualquier teléfono que no sea claramente ficticio.
Ningún endpoint se escribe a mano: lo que está en la referencia está en los archivos, y nada más. Cada solicitud de la colección usa como ejemplo los parámetros obligatorios de la referencia.
Preguntas frecuentes
¿La especificación es pública y gratuita?
Sí. Los archivos son públicos y puedes descargar e importar la especificación de ZapZap API. Usar la API requiere una cuenta y las claves x-api-key y x-api-secret.
¿Qué diferencia hay con el OpenAPI de api.zapzapapi.com?
Ambos describen los mismos endpoints. El de api.zapzapapi.com está en portugués; los archivos de esta página existen también en inglés y español, y la colección Postman ya viene lista.
¿Necesito una cuenta para probar en Postman?
Para abrir e importar los archivos, no. Para que las llamadas funcionen necesitas tus claves y una instancia, que se crean en el panel.
¿Con qué frecuencia cambian los archivos?
Cuando cambia la referencia de la API, los archivos se regeneran en el mismo despliegue del sitio.
Consigue tus claves y haz la primera llamada
R$ 15 por número activo al mes, sin cobro por mensaje. Al crear tu cuenta y verificar tu teléfono recibes un crédito de bienvenida sin depositar (uno por teléfono, sujeto a la campaña vigente).