Introducción a la API

¡Bienvenido a la API de Wasapia! Nuestra sencilla API REST te permite integrar y automatizar tu comunicación con WhatsApp.

URL base

Todas las peticiones a la API deben hacerse a:

https://api.wasapia.com/v1

Autenticación

La API usa claves de API para la autenticación. Genera tu clave de API desde tu panel de control.

Usar tu clave de API

Incluye tu clave de API en la cabecera X-WASAPIA-API-KEY:

curl -H "X-WASAPIA-API-KEY: TU_CLAVE_API" \
     https://api.wasapia.com/v1/contacts

Obtener tu clave de API

1. Inicia sesión en tu panel de Wasapia
2. Ve a Configuración → Claves de API
3. Haz clic en Generar nueva clave
4. Copia y guarda tu clave de forma segura

⚠️ Importante: Mantén tu clave de API segura y nunca la expongas en código del lado del cliente.

Formato de las peticiones

• Usa HTTPS para todas las peticiones
• Incluye la cabecera Content-Type: application/json en las peticiones POST/PUT
• Envía los datos como JSON en el cuerpo de la petición

Formato de las respuestas

Todas las respuestas son JSON con esta estructura:

Respuesta de éxito

{
  "success": true,
  "message": "Operación completada correctamente",
  "data": {}
}

Respuesta de error

{
  "success": false,
  "message": "Validación fallida",
  "errors": [
    {
      "msg": "El número de teléfono debe estar en formato internacional (+1234567890)",
      "param": "phoneNumber",
      "location": "body"
    }
  ]
}

Límites de velocidad

La API tiene límites de velocidad para garantizar la calidad del servicio:

• 1.500 peticiones por hora por clave de API

Cuando superes el límite, recibirás una respuesta 429 Too Many Requests.

¿Listo para empezar? Obtén tu clave de API y comienza a integrar.