Documentación API

¡Bienvenido a la documentación de la API de NonMail! Esta API te permite crear y gestionar direcciones de correo temporal de forma programática.

Endpoints API

Nuestra API está diseñada para ser simple y fácil de usar. Todos los endpoints son accesibles a través de https://api.nonmail.com/v1/

POST/v1/email/create

Crear una nueva dirección de correo temporal

Crea una nueva dirección de correo temporal.

Cuerpo de la Solicitud:

json

{{
  "duration": 300,
  "prefix": "my-temp-mail"
}}

Respuesta:

json

{{
  "status": "success",
  "email": "my-temp-mail_12345@nonmail.com",
  "token": "your_access_token",
  "expires_at": 1678886400
}}

GET/v1/email/inbox

Obtener correos para una dirección

Recupera todos los correos recibidos por una dirección de correo temporal específica.

Encabezados:

bash

Authorization: Bearer your_access_token

Respuesta:

json

{{
  "status": "success",
  "emails": [
    {{
      "id": "email_id_1",
      "from": "sender@example.com",
      "subject": "Hola desde NonMail",
      "body_preview": "Esta es una vista previa del contenido del correo...",
      "received_at": 1678885000
    }}
  ]
}}

GET/v1/email/message/email_id_1

Obtener un correo específico

Recupera el contenido completo de un correo específico.

Encabezados:

bash

Authorization: Bearer your_access_token

Respuesta:

json

{{
  "status": "success",
  "id": "email_id_1",
  "from": "sender@example.com",
  "subject": "Hola desde NonMail",
  "body": "<html><body><p>El contenido completo del correo va aquí.</p></body></html>",
  "received_at": 1678885000
}}

Autenticación

Todos los endpoints autenticados requieren un token API obtenido al crear un nuevo correo. Pasa este token en el encabezado Authorization como un token Bearer.

bash

Authorization: Bearer your_access_token

Manejo de Errores

Nuestra API utiliza códigos de estado HTTP estándar para indicar el éxito o fallo de una solicitud API.

200 OKLa solicitud fue exitosa.

400 Solicitud IncorrectaLa solicitud estaba malformada o era inválida.

401 No AutorizadoToken API faltante o inválido.

404 No EncontradoNo se pudo encontrar el recurso solicitado.

500 Error Interno del ServidorAlgo salió mal de nuestro lado.

Límites de Velocidad

Para asegurar un uso justo, implementamos límites de velocidad. Actualmente, se te permite 100 solicitudes por minuto por dirección IP. Exceder este límite resultará en un error 429 Too Many Requests.

Soporte de Idiomas

La documentación de la API está disponible en 8 idiomas. Puedes especificar el idioma deseado estableciendo el encabezado Accept-Language en tus solicitudes API, o seleccionándolo en la página de documentación.

Ejemplo: Accept-Language: ar para árabe.

bash

Accept-Language: ar

Soporte

Si tienes alguna pregunta o encuentras problemas, por favor contacta a nuestro equipo de soporte en support@nonmail.com.

Ejemplo de Uso

Aquí tienes un ejemplo completo de cómo usar la API con curl:

bash

curl -X POST https://api.nonmail.com/v1/email/create \
  -H "Content-Type: application/json" \
  -d '{{
    "duration": 300,
    "prefix": "my-temp-mail"
  }}'