Claves de API con entornos y permisos
Una clave por aplicación, con el permiso mínimo que necesita. Las de prueba no envían correo real y las de producción solo se crean con un dominio verificado.
Revisado el
curl https://api.vemudo.com/v1/me \
-H "Authorization: Bearer $VEMUDO_API_KEY"Entornos y permisos
vm_<entorno>_... . El secreto completo solo se muestra al crearla: Vemudo guarda únicamente un hash, así que si lo pierdes tienes que crear otra clave y revocar la antigua. Cada clave pertenece a un entorno y solo ve los recursos de ese entorno.
| Scope | Para qué sirve |
|---|---|
| send | Enviar, cancelar y consultar los emails creados con esa misma clave. |
| read | Solo lectura de toda la organización; no puede enviar ni modificar. |
| full | Todo lo anterior más las escrituras sobre bajas y webhooks. |
test no llama al proveedor de correo y no consume cuota; una live envía de verdad y solo se puede crear con un dominio verificado . Un email de un entorno nunca es visible desde el otro.
Gestión y límites
Pueden crear y revocar claves los roles owner, admin y developer. Hasta 25 claves activas por organización y 20 altas por hora. Revocar es inmediato y queda en la auditoría de la organización; nunca se registra el secreto. Límite de 10 peticiones por segundo por organización, con las cabeceras RateLimit-Limit,RateLimit-RemainingyRateLimit-Resety unRetry-Afteral superarlo.Una cookie de sesión del panel no autentica la API: /v1ignora las cookies.
Preguntas frecuentes
¿Puedo recuperar una clave que he perdido?
No. Vemudo solo guarda un hash y el secreto se muestra una vez al crearla. Crea otra clave y revoca la antigua.
¿Qué scope debo elegir?
El mínimo: send para una integración que solo envía, read para un panel de métricas o un asistente que solo consulta, y full solo si necesitas escribir bajas o webhooks.
¿Puedo usar la clave en una aplicación web o móvil?
No. La API no admite CORS y la clave quedaría visible. Llama siempre desde tu servidor.
Prueba Vemudo en la beta
Pide acceso, conecta tu dominio y envía. Revisamos cada cuenta antes de activarla.