Referencia de la API
Referencia de la API de Vemudo generada del contrato OpenAPI: autenticación, convenciones y cada operación con su ruta, scope, parámetros, respuestas y ejemplo curl.
Antes de empezar
curl. Para entender los conceptos, empieza por las guías.
Autenticación
Authorization. La URL base es https://api.vemudo.com.
curl https://api.vemudo.com/v1/me \
-H "Authorization: Bearer $VEMUDO_API_KEY"test o live) y un scope (send, read o full; full incluye los otros dos). Si falta el permiso, la API responde 403 insufficient_scope. Detalles en Autenticación y claves.
Convenciones
JSON en camelCase, fechas en ISO 8601 UTC y estados en minúsculas. Los listados devuelven { "data": [], "nextCursor": "..." };limitva de 1 a 100 ycursores opaco.Los errores usan application/problem+jsoncon uncodeestable. Ver Errores y límites.Límite general: 10 peticiones por segundo por organización.
Operaciones por sección
Clave y organización
Comprueba la clave que usas y la organización a la que pertenece.
Cuenta
Resumen de la cuenta: plan, uso del periodo, límites y recuentos.
Emails
Enviar, cancelar y consultar emails y sus eventos.
Estadísticas
Cifras de envío por día y tasas de entrega, rebote, queja, apertura y clic.
Dominios
Dominios de envío, su verificación y sus registros DNS.
Contactos
Consulta de contactos de la organización.
Listas
Listas de contactos con su número de miembros.
Segmentos
Segmentos guardados y su definición.
Campañas
Campañas y sus métricas.
Plantillas
Plantillas publicadas y su contenido.
Bajas y bloqueos
Direcciones a las que no se envía.
Webhooks
Endpoints que reciben los eventos de tus emails.