Referencia de API
Construya sobre BeeCastly con nuestra API REST con todas las funciones. Administre contactos, envíe mensajes, cree campañas y configure webhooks mediante programación.
URL base
https://beecastly.com/apiTodos los puntos finales de API son relativos a esta URL base. Las solicitudes deben incluir una clave API válida o un token JWT.
Inicio rápido
curl -X GET https://beecastly.com/api/contacts \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "x-tenant-id: YOUR_TENANT_ID" \ -H "Content-Type: application/json"
Autenticación
Todas las solicitudes requieren autenticación a través de uno de:
- Clave API: pase la autorización: encabezado portador YOUR_API_KEY
- Token JWT: obtenido de POST /auth/login
Además, incluya su ID de inquilino: x-tenant-id: YOUR_TENANT_ID
Puntos finales API
Autenticación
Iniciar sesión, registrarse, claves API, tokens JWT
Contactos
Operaciones CRUD, etiquetas, segmentos, campos personalizados
Mensajes
Envía WhatsApp, correo electrónico, SMS. Obtener conversaciones
Campañas
Crear, programar y realizar un seguimiento de campañas
Ganchos web
Suscripciones a eventos, cargas útiles, verificación
robots
Sesiones de bots de IA, mensajes y datos de entrenamiento
Formato de respuesta
Todas las respuestas siguen un formato JSON consistente:
// Success
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": "Error message description"
}Límites de tarifas
Nivel gratuito: 100 solicitudes/minuto
Nivel Pro: 1000 solicitudes/minuto
Empresa: límites personalizados
Los encabezados de límite de tasa se incluyen en cada respuesta: X-RateLimit-Remaining