API para desarrolladores de VookMail

Crea bandejas de entrada temporales y lee mensajes desde tus propias aplicaciones con una API REST sencilla. Las respuestas son JSON.

Autenticación

Envía tu clave de API en el encabezado Authorization. Las claves las emite el propietario del sitio.

curl https://www.vookmail.com/api/v1/domains \
  -H "Authorization: Bearer vk_your_key"

Endpoints

URL base: https://www.vookmail.com/api/v1

Método	Ruta	Descripción
GET	/domains	Listar los dominios disponibles
POST	/mailboxes	Crear un buzón. Cuerpo: nombre de usuario y dominio, ambos opcionales
GET	/mailboxes/{address}	Detalles del buzón y su caducidad
POST	/mailboxes/{address}/extend	Ampliar la duración del buzón
DELETE	/mailboxes/{address}	Cerrar el buzón y eliminar sus mensajes
GET	/mailboxes/{address}/messages?after={id}	Listar mensajes, con los códigos y enlaces detectados
GET	/mailboxes/{address}/messages/{id}	Leer un mensaje: HTML depurado, texto y archivos adjuntos
DELETE	/mailboxes/{address}/messages/{id}	Eliminar un mensaje
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Descargar un archivo adjunto

Ejemplo

curl -X POST https://www.vookmail.com/api/v1/mailboxes \
  -H "Authorization: Bearer vk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"myapp"}'

{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}

Errores y límites

Los errores devuelven un estado HTTP con error.code y error.message. Cada clave tiene un límite por minuto; si lo superas, se devuelve el estado 429.