Construir contra Run2Mail

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

Claves API Autenticación Puntos finales principales Códigos de error

Claves API

Genere claves API de desarrollador desde su panel de control. Cada clave se muestra completa solo una vez y luego se almacena como un hash seguro para verificación futura.

Cree claves desde su panel de control conectado.
Mantenga las claves privadas y guárdelas en su propio administrador secreto.
Revocar claves antiguas siempre que un dispositivo, script o compañero de equipo ya no necesite acceso.

Autenticación

Utilice un token de portador en el encabezado de Autorización para cada solicitud protegida.

Authorization: Bearer YOUR_API_KEY

Si la clave no es válida, está revocada o falta, la API responde con un error de autenticación.

Puntos finales principales

El flujo de trabajo más común es: inspeccionar al usuario autenticado, crear una bandeja de entrada y luego recuperar mensajes de esa bandeja de entrada.

Consulta la cuenta corriente

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Crear una bandeja de entrada

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Obtener mensajes de la bandeja de entrada

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Ejemplo de respuesta JSON

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Limitación de velocidad

Run2Mail aplica límites de solicitudes basados en planes y límites de creación diaria de bandejas de entrada para proteger el servicio y mantener estable el acceso a la API.

Los límites de las tarifas por minuto dependen de su plan activo.
Los límites de creación de correo electrónico se rastrean por separado de las llamadas de lectura básicas.
El uso se registra para mayor visibilidad dentro del panel de análisis del administrador.

Códigos de error

401: Credenciales de API faltantes o no válidas.
403: Acceso bloqueado, restringido o no permitido para la solicitud.
429: El volumen de solicitudes superó el límite actual.
503: API de desarrollador inhabilitada temporalmente por la plataforma.

Próximamente capturas de pantalla de la API del panel de control

Esta área está reservada para futuras capturas de pantalla del administrador de claves API y del panel de uso.

API para desarrolladores