Saltar al contenido

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

Comprobar qué clave estás usando y qué puede hacer
curl https://api.vemudo.com/v1/me \
  -H "Authorization: Bearer $VEMUDO_API_KEY"

Entornos y permisos

Una clave tiene la forma 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.

Permisos de las claves de API
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.

Una clave 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-Remaining y RateLimit-Reset y un Retry-After al superarlo.
  • Una cookie de sesión del panel no autentica la API: /v1 ignora las cookies.

Usa una clave por aplicación o entorno para revocarlas por separado, guárdala en una variable de entorno y rota las claves con regularidad. Úsalas con la API de envío , los webhooks o el servidor MCP .

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.

Pedir acceso a la beta