Documentación de la API de TempMail

REST API v1 y Webhooks

TempMailg Documentación de la API para desarrolladores

Utilice esta documentación para generar su clave de API personal, conectar el host de API de usuario dedicado, leer mensajes de la bandeja de entrada, administrar las bandejas de entrada propiedad del usuario e integrar TempMail en sus propias aplicaciones o automatizaciones.

Autenticación con token Bearer Webhooks en tiempo real Alias de Gmail y Outlook Respuestas JSON
URL Base de API de Usuario HTTPS
Formato de solicitud Utilice su clave de API solo en el encabezado de autorización Bearer y mantenga las URL de punto de conexión limpias.

Gestión del buzón

Obtenga dominios permitidos, cree o cambie buzones, elija duraciones permitidas y elimine direcciones propias.

GET https://v1.tempmailg.com/api/domains?type={type}
#

Listar dominios permitidos

Enumere los dominios disponibles para crear correos electrónicos temporales. Filtre por tipo para ver solo dominios gratuitos, premium o personalizados compatibles con su plan de suscripción.

Parámetros 1
Parámetro Ubicación Tipo Estado Descripción
type query string opcional
Filtro de nivel de dominio. La omisión usa todos cuando el acceso a dominio premium está habilitado, de lo contrario gratuito. Valores reconocidos: free, basic, pro, premium, custom, ultimate, all
Predeterminado: Dependiente de la cuenta
Obtener dominios permitidos
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "requested_type": "free",
        "plan": "pro",
        "plan_name": "Pro Plan",
        "allowed_types": [
            "free",
            "basic",
            "pro",
            "premium",
            "custom",
            "ultimate",
            "all"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.requested_type string
Filtro de dominio aplicado.
data.plan string
Etiqueta del plan actual.
data.plan_name string
Nombre legible del plan actual.
data.allowed_types array<string>
Filtros de dominio disponibles para esta cuenta. Un filtro reconocido aún puede estar prohibido para su plan.
data.domains array
Dominios seleccionables después del filtrado; una matriz vacía es válida.
data.domains[].domain string
Nombre de dominio seleccionable.
data.domains[].type string
Etiqueta del nivel de dominio legible.
data.domains[].custom boolean
Si esto es un dominio personalizado.
POST https://v1.tempmailg.com/api/emails
#

Crear buzón temporal

Cree un buzón temporal propio. Omitir nombre de usuario y dominio para generación aleatoria, o proporcionar un nombre de usuario personalizado permitido y un dominio permitido. El parámetro provider puede seleccionar la generación de alias de Gmail u Outlook.

Parámetros 8
Parámetro Ubicación Tipo Estado Descripción
username body string opcional
Nombre de usuario personalizado opcional: de 2 a 64 caracteres ASCII, incluyendo letras, dígitos, puntos, guiones bajos o guiones. Requiere permiso del plan; también se acepta custom_username.
Predeterminado: Generado aleatoriamente
domain body string opcional
Uno de los dominios permitidos devueltos por GET /domains. La omisión elige un dominio permitido aleatorio.
Predeterminado: Dominio permitido aleatorio
lifetime body string opcional
valores permitidos:
10m — 10 minutos 1h — 1 Hora 2h — 2 Horas 1d — 1 día 1w — 1 Semana 1m — 30 Días 3m — 90 días 6m — 180 días 1y — 365 días unlimited — Ilimitado
Predeterminado: Vida útil predeterminada del plan
provider body string opcional
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
Predeterminado: standard
pin_enabled body boolean opcional
Protección opcional con PIN para el nuevo buzón, cuando lo permita su plan. No cambia el PIN de un buzón existente.
Predeterminado: false
pin body string opcional
Requerido cuando pin_enabled es true: un PIN de 6 a 8 dígitos, enviado como una cadena para preservar los ceros iniciales.
pin_confirmation body string opcional
Requerido cuando pin_enabled es true. Debe coincidir exactamente con pin.
Idempotency-Key header string opcional
Requerido para la creación o eliminación protegida por PIN: una clave estable de 16 a 128 caracteres. Reintente la solicitud idéntica con la misma clave para evitar trabajo duplicado.
Parámetros del cuerpo opcionales: username (nombre de usuario personalizado si lo permite el plan), domain (dominio permitido, p. ej. example.com), lifetime (valores permitidos: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Omita la duración, o déjela vacía, para usar la Duración de Correo Electrónico Predeterminada configurada para su plan mensual/anual actual. Envíe una duración permitida, como 1h, para sobrescribir esa predeterminada. Ilimitado se usa solo cuando está configurado como la opción predeterminada del plan o se solicita explícitamente y está permitido. Los parámetros del cuerpo mailbox_lifetime y email_lifetime también son aceptados; el primer valor no vacío gana en este orden: lifetime, mailbox_lifetime, email_lifetime. Los valores inválidos o no permitidos devuelven HTTP 422 en lugar de seleccionar silenciosamente un valor predeterminado.
Crear buzón
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:18:04+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:04+00:00",
        "email_token": "encrypted-email-token"
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.id integer
ID del buzón. Los IDs generados, direcciones y tokens difieren para cada buzón.
data.pin_protected boolean
Indica si este buzón tiene protección con PIN. No se devuelve el PIN ni el hash del PIN.
data.email string
Dirección completa del buzón generada.
data.domain string
Dominio del buzón generado.
data.provider string
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
data.expire_at string|null
Fecha de expiración efectiva como una marca de tiempo ISO-8601, o null para un buzón ilimitado.
data.expires_in_seconds number|null
Segundos restantes no negativos al calcular; pueden ser segundos fraccionarios. Null significa ilimitado, no cero.
data.mailbox_state string
Estado actual del buzón: activo, en pausa, expirado o inactivo.
data.receiving_enabled boolean
Si este buzón actualmente acepta mensajes entrantes.
data.message_count integer
Recuento total de mensajes conocido; puede reflejar la última sincronización del buzón.
data.unread_message_count integer
Recuento de mensajes no leídos conocidos; puede reflejar la última sincronización del buzón.
data.last_message_received_at string|null
Última hora conocida de mensaje recibido en formato ISO-8601, o null cuando no esté disponible.
data.message_count_synced_at string|null
Última hora de sincronización del recuento de mensajes en formato ISO-8601, o null antes de la sincronización.
data.created_at string|null
Hora de creación del buzón en formato ISO-8601.
data.email_token string
Referencia opaca de buzón cifrado. No reemplaza la autenticación Bearer, las verificaciones de propiedad o la autorización PIN.
data.pin_grant object
Condicional: la creación de buzón protegido por PIN activo devuelve esta concesión de lectura; la creación ordinaria sin protección la omite.
data.pin_grant.mailbox_id integer
ID del buzón al que está vinculada la concesión de lectura condicional.
data.pin_grant.unlock_token string
Token de lectura opaco para X-Mailbox-Unlock con la misma credencial del propietario. Manténgalo privado y en memoria; una concesión de lectura no autoriza la eliminación.
data.pin_grant.scope string
El alcance leído para la concesión de creación condicional.
data.pin_grant.idle_timeout_seconds integer
Tiempo de inactividad permitido para la concesión de lectura, normalmente 3600 segundos.
data.pin_grant.absolute_timeout_seconds integer
Duración máxima del permiso de lectura, normalmente 86400 segundos.
data.pin_grant.expires_at string
Vencimiento actual de la concesión de lectura en formato ISO-8601.
data.pin_grant.absolute_expires_at string
Vencimiento absoluto de la concesión de lectura en formato ISO-8601. Los cambios de seguridad pueden revocar la concesión antes.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Actualizar / Cambiar Buzón

Crear o seleccionar un buzón en el nuevo nombre de usuario y dominio después de verificar la propiedad del buzón actual. Esto no renombra el buzón antiguo ni cambia su duración en el lugar. Cuando el destino difiere, el buzón antiguo permanece en el historial y puede ser pausado por los límites de buzones activos. Reutilizar su propio destino activo reaplica su duración solicitada o la predeterminada del plan.

Parámetros 9
Parámetro Ubicación Tipo Estado Descripción
email path string requerido
Dirección de correo electrónico completa actual del buzón propio a cambiar. Codifique en URL cada segmento de ruta; codifique un signo más como %2B.
username path string requerido
Nuevo nombre de usuario deseado: de 2 a 64 caracteres alfanuméricos; sujeto a permiso de nombre de usuario personalizado.
domain path string requerido
Nuevo nombre de dominio permitido.
lifetime body string opcional
valores permitidos:
10m — 10 minutos 1h — 1 Hora 2h — 2 Horas 1d — 1 día 1w — 1 Semana 1m — 30 Días 3m — 90 días 6m — 180 días 1y — 365 días unlimited — Ilimitado
Predeterminado: Vida útil predeterminada del plan
pin_enabled body boolean opcional
Protección opcional con PIN para el nuevo buzón, cuando lo permita su plan. No cambia el PIN de un buzón existente.
Predeterminado: false
pin body string opcional
Requerido cuando pin_enabled es true: un PIN de 6 a 8 dígitos, enviado como una cadena para preservar los ceros iniciales.
pin_confirmation body string opcional
Requerido cuando pin_enabled es true. Debe coincidir exactamente con pin.
Idempotency-Key header string opcional
Requerido para la creación o eliminación protegida por PIN: una clave estable de 16 a 128 caracteres. Reintente la solicitud idéntica con la misma clave para evitar trabajo duplicado.
X-Mailbox-Unlock header string opcional
Encabezado, solo buzones protegidos: use un unlock_token de lectura. Primero haga POST pin y scope=read a la URL de desbloqueo PIN. Mantenga su autenticación Bearer normal. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Usar un correo electrónico de un buzón de correo propiedad del usuario existente en {email}. Parámetro opcional del cuerpo: lifetime (valores permitidos: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Omita la duración, o déjela vacía, para usar la Duración de Correo Electrónico Predeterminada configurada para su plan mensual/anual actual. Envíe una duración permitida, como 1h, para sobrescribir esa predeterminada. Ilimitado se usa solo cuando está configurado como la opción predeterminada del plan o se solicita explícitamente y está permitido. Los parámetros del cuerpo mailbox_lifetime y email_lifetime también son aceptados; el primer valor no vacío gana en este orden: lifetime, mailbox_lifetime, email_lifetime. Los valores inválidos o no permitidos devuelven HTTP 422 en lugar de seleccionar silenciosamente un valor predeterminado.
Actualizar buzón de correo propiedad del usuario
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:28:04+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:04+00:00",
        "email_token": "encrypted-email-token"
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.id integer
ID del buzón. Los IDs generados, direcciones y tokens difieren para cada buzón.
data.pin_protected boolean
Indica si este buzón tiene protección con PIN. No se devuelve el PIN ni el hash del PIN.
data.email string
Dirección completa del buzón generada.
data.domain string
Dominio del buzón generado.
data.provider string
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
data.expire_at string|null
Fecha de expiración efectiva como una marca de tiempo ISO-8601, o null para un buzón ilimitado.
data.expires_in_seconds number|null
Segundos restantes no negativos al calcular; pueden ser segundos fraccionarios. Null significa ilimitado, no cero.
data.mailbox_state string
Estado actual del buzón: activo, en pausa, expirado o inactivo.
data.receiving_enabled boolean
Si este buzón actualmente acepta mensajes entrantes.
data.message_count integer
Recuento total de mensajes conocido; puede reflejar la última sincronización del buzón.
data.unread_message_count integer
Recuento de mensajes no leídos conocidos; puede reflejar la última sincronización del buzón.
data.last_message_received_at string|null
Última hora conocida de mensaje recibido en formato ISO-8601, o null cuando no esté disponible.
data.message_count_synced_at string|null
Última hora de sincronización del recuento de mensajes en formato ISO-8601, o null antes de la sincronización.
data.created_at string|null
Hora de creación del buzón en formato ISO-8601.
data.email_token string
Referencia opaca de buzón cifrado. No reemplaza la autenticación Bearer, las verificaciones de propiedad o la autorización PIN.
data.pin_grant object
Condicional: la creación de buzón protegido por PIN activo devuelve esta concesión de lectura; la creación ordinaria sin protección la omite.
data.pin_grant.mailbox_id integer
ID del buzón al que está vinculada la concesión de lectura condicional.
data.pin_grant.unlock_token string
Token de lectura opaco para X-Mailbox-Unlock con la misma credencial del propietario. Manténgalo privado y en memoria; una concesión de lectura no autoriza la eliminación.
data.pin_grant.scope string
El alcance leído para la concesión de creación condicional.
data.pin_grant.idle_timeout_seconds integer
Tiempo de inactividad permitido para la concesión de lectura, normalmente 3600 segundos.
data.pin_grant.absolute_timeout_seconds integer
Duración máxima del permiso de lectura, normalmente 86400 segundos.
data.pin_grant.expires_at string
Vencimiento actual de la concesión de lectura en formato ISO-8601.
data.pin_grant.absolute_expires_at string
Vencimiento absoluto de la concesión de lectura en formato ISO-8601. Los cambios de seguridad pueden revocar la concesión antes.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Eliminar buzón

Eliminar un buzón propio e invocar su limpieza de mensajes y archivos. Los registros de buzón retenidos pueden ser eliminados suavemente internamente; la dirección ya no es utilizable a través de la API.

Parámetros 3
Parámetro Ubicación Tipo Estado Descripción
email path string requerido
Dirección de correo electrónico completa del buzón propio a eliminar. Codifique la dirección en URL; codifique el signo más como %2B.
X-Mailbox-Unlock header string opcional
Encabezado, solo buzones protegidos: use el token de desbloqueo de eliminación de un solo uso unlock_token. Primero POST pin, scope=delete y la acción/target_id devuelta por la respuesta 423 a la URL de desbloqueo PIN. Un token de lectura no puede eliminar. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opcional
Requerido para la creación o eliminación protegida por PIN: una clave estable de 16 a 128 caracteres. Reintente la solicitud idéntica con la misma clave para evitar trabajo duplicado.
Eliminar buzón de correo propiedad del usuario
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
message string
Resultado de la eliminación. Un recurso faltante devuelve HTTP 404.

Alias de Gmail y Outlook

Generar buzones alias de Gmail y Outlook/Hotmail de alta reputación.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Crear alias de Gmail

Crear un nuevo buzón temporal de alias de Gmail, propiedad del usuario autenticado.

Parámetros 8
Parámetro Ubicación Tipo Estado Descripción
mode body string opcional
Modo de generación: auto, dot, plus o plus_dot. También acepta gmail_alias_mode. Si la selección de estilo no está permitida, se usa auto.
Predeterminado: auto
username body string opcional
Sufijo de alias personalizado opcional: de 2 a 32 letras o dígitos ASCII, normalizado a minúsculas; sujeto a permiso de la función. También acepta custom_username o alias_username.
Predeterminado: Generado automáticamente
domain body string opcional
Utilice aleatorio, gmail.com o googlemail.com; alias_domain también es aceptado. La omisión o la falta de permiso de selección de dominio utiliza aleatorio.
Predeterminado: random
lifetime body string opcional
valores permitidos:
10m — 10 minutos 1h — 1 Hora 2h — 2 Horas 1d — 1 día 1w — 1 Semana 1m — 30 Días 3m — 90 días 6m — 180 días 1y — 365 días unlimited — Ilimitado
Predeterminado: Vida útil predeterminada del plan
pin_enabled body boolean opcional
Protección opcional con PIN para el nuevo buzón, cuando lo permita su plan. No cambia el PIN de un buzón existente.
Predeterminado: false
pin body string opcional
Requerido cuando pin_enabled es true: un PIN de 6 a 8 dígitos, enviado como una cadena para preservar los ceros iniciales.
pin_confirmation body string opcional
Requerido cuando pin_enabled es true. Debe coincidir exactamente con pin.
Idempotency-Key header string opcional
Requerido para la creación o eliminación protegida por PIN: una clave estable de 16 a 128 caracteres. Reintente la solicitud idéntica con la misma clave para evitar trabajo duplicado.
Requiere que el permiso Gmail Alias API esté habilitado en su plan de suscripción o desbloqueado mediante un paquete de Créditos API. Parámetros opcionales: mode (auto, dot, plus, plus_dot), username (nombre de usuario de alias personalizado), domain (p. ej. gmail.com, googlemail.com), lifetime (valores permitidos: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Omita la duración, o déjela vacía, para usar la Duración de Correo Electrónico Predeterminada configurada para su plan mensual/anual actual. Envíe una duración permitida, como 1h, para sobrescribir esa predeterminada. Ilimitado se usa solo cuando está configurado como la opción predeterminada del plan o se solicita explícitamente y está permitido. Los parámetros del cuerpo mailbox_lifetime y email_lifetime también son aceptados; el primer valor no vacío gana en este orden: lifetime, mailbox_lifetime, email_lifetime. Los valores inválidos o no permitidos devuelven HTTP 422 en lugar de seleccionar silenciosamente un valor predeterminado.
Crear buzón alias de Gmail
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:18:04+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:04+00:00",
        "email_token": "encrypted-email-token"
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.id integer
ID del buzón. Los IDs generados, direcciones y tokens difieren para cada buzón.
data.pin_protected boolean
Indica si este buzón tiene protección con PIN. No se devuelve el PIN ni el hash del PIN.
data.email string
Dirección completa del buzón generada.
data.domain string
Dominio del buzón generado.
data.provider string
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
data.expire_at string|null
Fecha de expiración efectiva como una marca de tiempo ISO-8601, o null para un buzón ilimitado.
data.expires_in_seconds number|null
Segundos restantes no negativos al calcular; pueden ser segundos fraccionarios. Null significa ilimitado, no cero.
data.mailbox_state string
Estado actual del buzón: activo, en pausa, expirado o inactivo.
data.receiving_enabled boolean
Si este buzón actualmente acepta mensajes entrantes.
data.message_count integer
Recuento total de mensajes conocido; puede reflejar la última sincronización del buzón.
data.unread_message_count integer
Recuento de mensajes no leídos conocidos; puede reflejar la última sincronización del buzón.
data.last_message_received_at string|null
Última hora conocida de mensaje recibido en formato ISO-8601, o null cuando no esté disponible.
data.message_count_synced_at string|null
Última hora de sincronización del recuento de mensajes en formato ISO-8601, o null antes de la sincronización.
data.created_at string|null
Hora de creación del buzón en formato ISO-8601.
data.email_token string
Referencia opaca de buzón cifrado. No reemplaza la autenticación Bearer, las verificaciones de propiedad o la autorización PIN.
data.pin_grant object
Condicional: la creación de buzón protegido por PIN activo devuelve esta concesión de lectura; la creación ordinaria sin protección la omite.
data.pin_grant.mailbox_id integer
ID del buzón al que está vinculada la concesión de lectura condicional.
data.pin_grant.unlock_token string
Token de lectura opaco para X-Mailbox-Unlock con la misma credencial del propietario. Manténgalo privado y en memoria; una concesión de lectura no autoriza la eliminación.
data.pin_grant.scope string
El alcance leído para la concesión de creación condicional.
data.pin_grant.idle_timeout_seconds integer
Tiempo de inactividad permitido para la concesión de lectura, normalmente 3600 segundos.
data.pin_grant.absolute_timeout_seconds integer
Duración máxima del permiso de lectura, normalmente 86400 segundos.
data.pin_grant.expires_at string
Vencimiento actual de la concesión de lectura en formato ISO-8601.
data.pin_grant.absolute_expires_at string
Vencimiento absoluto de la concesión de lectura en formato ISO-8601. Los cambios de seguridad pueden revocar la concesión antes.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Dominios de alias de Outlook

Obtener dominios alias activos de Outlook / Hotmail disponibles para la generación de buzones.

Requiere que el permiso de la API de Alias de Outlook esté habilitado en su plan de suscripción o desbloqueado mediante un paquete de Créditos de API. Indica si la selección de dominio específica está desbloqueada en su plan.
Obtener dominios de alias de Outlook
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "domains": [
            {
                "domain": "outlook.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            },
            {
                "domain": "hotmail.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            }
        ]
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.domains array
Dominios Outlook/Hotmail activos; una matriz vacía es válida.
data.domains[].domain string
Nombre de dominio disponible.
data.domains[].type string
Etiqueta de proveedor legible.
data.domains[].selectable boolean
Si su cuenta puede elegir explícitamente este dominio.
data.domains[].locked boolean
Si la selección explícita de dominio está bloqueada para su cuenta.
data.domains[].disabled_reason string|null
Razón por la que la selección de dominio está bloqueada, o nulo cuando es seleccionable.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Crear alias de Outlook

Crear un nuevo buzón temporal de alias de Outlook / Hotmail propiedad del usuario autenticado.

Parámetros 7
Parámetro Ubicación Tipo Estado Descripción
domain body string opcional
Use aleatorio o un dominio de GET /outlook-alias/domains; outlook_alias_domain también es aceptado. Sin permiso de selección, se usa aleatorio.
Predeterminado: Dominio disponible aleatorio
username body string opcional
Sufijo de alias personalizado opcional: de 2 a 32 letras o dígitos ASCII, normalizado a minúsculas; sujeto a permiso de la función. También acepta custom_username o alias_username.
Predeterminado: Generado automáticamente
lifetime body string opcional
valores permitidos:
10m — 10 minutos 1h — 1 Hora 2h — 2 Horas 1d — 1 día 1w — 1 Semana 1m — 30 Días 3m — 90 días 6m — 180 días 1y — 365 días unlimited — Ilimitado
Predeterminado: Vida útil predeterminada del plan
pin_enabled body boolean opcional
Protección opcional con PIN para el nuevo buzón, cuando lo permita su plan. No cambia el PIN de un buzón existente.
Predeterminado: false
pin body string opcional
Requerido cuando pin_enabled es true: un PIN de 6 a 8 dígitos, enviado como una cadena para preservar los ceros iniciales.
pin_confirmation body string opcional
Requerido cuando pin_enabled es true. Debe coincidir exactamente con pin.
Idempotency-Key header string opcional
Requerido para la creación o eliminación protegida por PIN: una clave estable de 16 a 128 caracteres. Reintente la solicitud idéntica con la misma clave para evitar trabajo duplicado.
Requiere que el permiso de la API de Alias de Outlook esté habilitado en su plan de suscripción o desbloqueado mediante un paquete de Créditos de API. Parámetros opcionales: domain (p. ej. outlook.com, hotmail.com), username (nombre de usuario de alias personalizado), lifetime (valores permitidos: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Omita la duración, o déjela vacía, para usar la Duración de Correo Electrónico Predeterminada configurada para su plan mensual/anual actual. Envíe una duración permitida, como 1h, para sobrescribir esa predeterminada. Ilimitado se usa solo cuando está configurado como la opción predeterminada del plan o se solicita explícitamente y está permitido. Los parámetros del cuerpo mailbox_lifetime y email_lifetime también son aceptados; el primer valor no vacío gana en este orden: lifetime, mailbox_lifetime, email_lifetime. Los valores inválidos o no permitidos devuelven HTTP 422 en lugar de seleccionar silenciosamente un valor predeterminado.
Crear buzón de alias de Outlook
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:18:04+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:04+00:00",
        "email_token": "encrypted-email-token"
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.id integer
ID del buzón. Los IDs generados, direcciones y tokens difieren para cada buzón.
data.pin_protected boolean
Indica si este buzón tiene protección con PIN. No se devuelve el PIN ni el hash del PIN.
data.email string
Dirección completa del buzón generada.
data.domain string
Dominio del buzón generado.
data.provider string
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
data.expire_at string|null
Fecha de expiración efectiva como una marca de tiempo ISO-8601, o null para un buzón ilimitado.
data.expires_in_seconds number|null
Segundos restantes no negativos al calcular; pueden ser segundos fraccionarios. Null significa ilimitado, no cero.
data.mailbox_state string
Estado actual del buzón: activo, en pausa, expirado o inactivo.
data.receiving_enabled boolean
Si este buzón actualmente acepta mensajes entrantes.
data.message_count integer
Recuento total de mensajes conocido; puede reflejar la última sincronización del buzón.
data.unread_message_count integer
Recuento de mensajes no leídos conocidos; puede reflejar la última sincronización del buzón.
data.last_message_received_at string|null
Última hora conocida de mensaje recibido en formato ISO-8601, o null cuando no esté disponible.
data.message_count_synced_at string|null
Última hora de sincronización del recuento de mensajes en formato ISO-8601, o null antes de la sincronización.
data.created_at string|null
Hora de creación del buzón en formato ISO-8601.
data.email_token string
Referencia opaca de buzón cifrado. No reemplaza la autenticación Bearer, las verificaciones de propiedad o la autorización PIN.
data.pin_grant object
Condicional: la creación de buzón protegido por PIN activo devuelve esta concesión de lectura; la creación ordinaria sin protección la omite.
data.pin_grant.mailbox_id integer
ID del buzón al que está vinculada la concesión de lectura condicional.
data.pin_grant.unlock_token string
Token de lectura opaco para X-Mailbox-Unlock con la misma credencial del propietario. Manténgalo privado y en memoria; una concesión de lectura no autoriza la eliminación.
data.pin_grant.scope string
El alcance leído para la concesión de creación condicional.
data.pin_grant.idle_timeout_seconds integer
Tiempo de inactividad permitido para la concesión de lectura, normalmente 3600 segundos.
data.pin_grant.absolute_timeout_seconds integer
Duración máxima del permiso de lectura, normalmente 86400 segundos.
data.pin_grant.expires_at string
Vencimiento actual de la concesión de lectura en formato ISO-8601.
data.pin_grant.absolute_expires_at string
Vencimiento absoluto de la concesión de lectura en formato ISO-8601. Los cambios de seguridad pueden revocar la concesión antes.

Mensajes y archivos adjuntos

Obtenga bandejas de entrada entrantes, lea mensajes completos en HTML/texto y transmita los archivos adjuntos.

GET https://v1.tempmailg.com/api/messages?email={email}
#

Listar mensajes del buzón

Recuperar los resúmenes de mensajes disponibles y los metadatos del buzón. Los escaneos estándar de la bandeja de entrada devuelven un lote reciente de hasta 25 mensajes; este no es un endpoint paginado de historial completo. Use GET /messages/{messageId} para obtener los cuerpos completos y los archivos adjuntos.

Parámetros 2
Parámetro Ubicación Tipo Estado Descripción
email query string requerido
Dirección de correo electrónico completa del buzón propio del que leer los mensajes. Codifique la consulta en URL; codifique el signo más como %2B.
X-Mailbox-Unlock header string opcional
Encabezado, solo buzones protegidos: use un unlock_token de lectura. Primero haga POST pin y scope=read a la URL de desbloqueo PIN. Mantenga su autenticación Bearer normal. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
El correo electrónico debe pertenecer a su cuenta. Los resúmenes estándar y de Gmail contienen campos OTP y verification-link; Outlook también incluye from_name, snippet, received_at y has_attachments. La sincronización del proveedor y el almacenamiento en caché pueden retrasar los nuevos mensajes y recuentos.
Leer mensajes del buzón de correo
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:18:04",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:18:04+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:18:04+00:00",
    "message_count_synced_at": "2026-11-19T02:18:04+00:00"
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
mailbox string
Dirección del buzón cuyos mensajes fueron solicitados.
email_token string
Referencia opaca de buzón cifrado; aún se requiere autenticación normal.
mailbox_provider string
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
messages array
Resúmenes de mensajes. Un buzón vacío devuelve una matriz vacía; recupera un solo mensaje para su cuerpo y archivos adjuntos.
expire_at string|null
Fecha de expiración efectiva como una marca de tiempo ISO-8601, o null para un buzón ilimitado.
expires_in_seconds number|null
Segundos restantes no negativos al calcular; pueden ser segundos fraccionarios. Null significa ilimitado, no cero.
mailbox_state string
Estado actual del buzón: activo, en pausa, expirado o inactivo.
receiving_enabled boolean
Si este buzón actualmente acepta mensajes entrantes.
message_count integer
Recuento total de mensajes conocido; puede reflejar la última sincronización del buzón.
unread_message_count integer
Recuento de mensajes no leídos conocidos; puede reflejar la última sincronización del buzón.
last_message_received_at string|null
Última hora conocida de mensaje recibido en formato ISO-8601, o null cuando no esté disponible.
message_count_synced_at string|null
Última hora de sincronización del recuento de mensajes en formato ISO-8601, o null antes de la sincronización.
mailbox_limit.limit integer
Límite activo de buzones para este proveedor; -1 significa ilimitado.
mailbox_limit.limit_label string
Etiqueta de visualización para el límite del buzón.
mailbox_limit.active_count integer
Número de buzones activos para este proveedor.
mailbox_limit.paused_count integer
Número de buzones en pausa para este proveedor.
mailbox_limit.paused_mailboxes array<string>
Direcciones pausadas por el límite del buzón.
mailbox_limit.remaining integer
Ranuras de buzón activo restantes; -1 significa ilimitado. Esto no es cuota de solicitudes API.
mailbox_limit.remaining_label string
Etiqueta de visualización para los espacios de buzón restantes.
mailbox_limit.reached boolean
Si se ha alcanzado el límite de buzones activos.
mailbox_limit.blocked boolean
Si el límite de buzón activo es cero.
mailbox_limit.provider string|null
Proveedor al que se aplica el límite del buzón.
messages[].id string
ID de mensaje opaco utilizado por los puntos finales de mensaje único, eliminación y adjunto.
messages[].is_seen boolean
Si el mensaje está marcado como leído.
messages[].subject string
Asunto del mensaje.
messages[].from string
Nombre para mostrar o dirección del remitente.
messages[].from_email string
Dirección de correo electrónico del remitente.
messages[].receivedAt string
Hora de recepción en la zona horaria de la aplicación, formateada como YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Detectado código de un solo uso cuando esté disponible y permitido; de lo contrario null.
messages[].otp_locked boolean
Si un código de un solo uso detectado está oculto por los permisos de la función.
messages[].verification_link string|null
URL de verificación detectada cuando está disponible y permitido; de lo contrario, null.
messages[].verification_link_locked boolean
Si un enlace de verificación detectado está oculto por los permisos de la función.
messages[].from_name string|null
Campo de resumen de Outlook: nombre del remitente original. Ausente de los resúmenes estándar y de Gmail.
messages[].snippet string|null
Campo de resumen de Outlook: vista previa corta del mensaje.
messages[].received_at string|null
Campo de resumen de Outlook: hora de recepción en formato ISO-8601, cuando se conozca.
messages[].has_attachments boolean
Campo de resumen de Outlook: si existe metadata de adjuntos. La disponibilidad de descarga se verifica por separado.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Obtener mensaje único

Recupera un mensaje propio mediante su ID de mensaje opaco. Devuelve los formatos del cuerpo y los metadatos de los archivos adjuntos. Los campos del cuerpo dependen del formato del mensaje; Outlook agrega campos específicos del proveedor que se enumeran a continuación.

Parámetros 2
Parámetro Ubicación Tipo Estado Descripción
messageId path string requerido
ID de mensaje único devuelto en la lista de mensajes.
X-Mailbox-Unlock header string opcional
Encabezado, solo buzones protegidos: use un unlock_token de lectura. Primero haga POST pin y scope=read a la URL de desbloqueo PIN. Mantenga su autenticación Bearer normal. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Leer un mensaje
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:18:04",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "html_content": "<p>Hello from the inbox.</p>",
        "text_content": "<pre>Hello from the inbox.</pre>",
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
data.id string
ID de mensaje opaco.
data.is_seen boolean
Estado de lectura del mensaje. Leer puede marcarlo como visto; los datos en caché pueden reflejar un estado anterior.
data.subject string
Asunto del mensaje.
data.from string
Nombre para mostrar o dirección del remitente.
data.from_email string
Dirección de correo electrónico del remitente.
data.to string
Dirección del buzón del destinatario.
data.mailbox_provider string
Proveedor de buzón: standard, gmail_alias, o outlook_alias.
data.receivedAt string
Hora de recepción en la zona horaria de la aplicación, formateada como YYYY-MM-DD HH:mm:ss.
data.html boolean
Si el mensaje tiene un cuerpo HTML.
data.html_content string
Cuerpo HTML cuando está presente. Los mensajes estándar sin HTML pueden omitir este campo. Trate el contenido del mensaje como no confiable.
data.text_content string
Cuerpo de texto cuando está presente; los mensajes estándar pueden contener texto escapado en un elemento pre o omitir este campo.
data.content string
Cuerpo preferido para mostrar, normalmente HTML cuando está disponible.
data.attachments array
Metadatos del adjunto, o una matriz vacía. Las descargas requieren autenticación normal y la autorización de PIN aplicable.
data.attachments[].name string
Nombre de archivo para codificar en URL como un solo segmento de ruta al descargar.
data.attachments[].size integer
Tamaño del adjunto en bytes.
data.attachments[].url string
Se añadió la URL de descarga de la API de usuario autenticado a los archivos adjuntos con un nombre de archivo. Una URL no garantiza que el archivo local esté disponible.
data.attachments[].extension string
Campo de metadatos estándar/Gmail: extensión de archivo cuando se proporciona.
data.attachments[].id string
Campo de metadatos de Outlook: ID de adjunto del proveedor.
data.attachments[].content_type string
Campo de metadatos de Outlook: tipo de contenido MIME.
data.from_name string|null
Campo de detalle de Outlook: nombre del remitente original.
data.to_email string|null
Campo de detalle de Outlook: dirección del destinatario original.
data.received_at string|null
Campo de detalle de Outlook: hora recibida en ISO-8601.
data.has_html boolean
Campo de detalle de Outlook: si existe un cuerpo HTML.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Eliminar mensaje

Eliminar un mensaje único propiedad del usuario.

Parámetros 3
Parámetro Ubicación Tipo Estado Descripción
messageId path string requerido
Cadena de ID de mensaje única para eliminar permanentemente.
X-Mailbox-Unlock header string opcional
Encabezado, solo buzones protegidos: use el token de desbloqueo de eliminación de un solo uso unlock_token. Primero POST pin, scope=delete y la acción/target_id devuelta por la respuesta 423 a la URL de desbloqueo PIN. Un token de lectura no puede eliminar. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opcional
Requerido para la creación o eliminación protegida por PIN: una clave estable de 16 a 128 caracteres. Reintente la solicitud idéntica con la misma clave para evitar trabajo duplicado.
Eliminar un mensaje
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Campos de respuesta
Campo Tipo Descripción
status boolean
Si la operación tuvo éxito.
message string
Resultado de la eliminación. Un recurso faltante devuelve HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Descargar archivo adjunto

Descargar un archivo adjunto de un mensaje propiedad del usuario.

Parámetros 3
Parámetro Ubicación Tipo Estado Descripción
messageId path string requerido
ID del mensaje que contiene el archivo.
filename path string requerido
Nombre de archivo y extensión del adjunto a descargar.
X-Mailbox-Unlock header string opcional
Encabezado, solo buzones protegidos: use un unlock_token de lectura. Primero haga POST pin y scope=read a la URL de desbloqueo PIN. Mantenga su autenticación Bearer normal. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
El éxito devuelve bytes del archivo, no JSON. Los archivos demasiado grandes devuelven HTTP 403; los archivos locales faltantes o no disponibles devuelven HTTP 404. Codifique el nombre de archivo en URL como un solo segmento de ruta. Los metadatos del adjunto por sí solos no garantizan la disponibilidad de la descarga.
Descargar un archivo adjunto
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt
Comportamiento de descarga Este punto final devuelve el archivo solicitado directamente en lugar de un cuerpo JSON.
Campos de respuesta
Campo Tipo Descripción
Content-Disposition header
La respuesta exitosa descarga el nombre de archivo solicitado.
body binary
Bytes del archivo en caso de éxito, no JSON. Los errores devuelven JSON con un estado que no es 2xx.

Límites de velocidad y cuotas

Supervise los presupuestos de solicitudes en tiempo real, los límites de velocidad y las cuotas de cuenta sin consumir créditos.

GET https://v1.tempmailg.com/api/rate-limit
#

Límite de velocidad y cuota

Verifique su límite de velocidad actual y el estado de la cuota sin consumir ningún uso de API. Este endpoint está libre de cuota y no deduce créditos mensuales de API (límite de protección contra abuso: 60 solicitudes/min).

X-RateLimit-* describe el presupuesto de solicitudes indicado; X-Quota-* describe la capacidad mensual y comprada cuando está disponible. X-Mailbox-RateLimit-* informa el presupuesto separado de creación/actualización de buzones. Un rechazo solo de buzón utiliza el alcance del buzón y su propia ventana de reintento. Los rechazos por límite por minuto pueden omitir la información de cuota. Retry-After se incluye solo para un reintento programado; el acceso deshabilitado puede requerir un cambio de cuenta. En esta respuesta de estado exitosa, data.limit, data.remaining y data.reset describen el presupuesto de minutos de la cuenta, no los créditos gastables. El objeto data.quota describe la asignación mensual, los saldos de crédito y el uso. Los campos existentes data.monthly_limit, data.monthly_remaining y data.purchased_credits siguen siendo alias de los campos correspondientes de la cuota. Una verificación de estado exitosa no autoriza otra operación de API. Las operaciones aún requieren acceso habilitado, cuota disponible y admisión a través de todos los límites aplicables. La instantánea de cuota no garantiza capacidad ya reservada por una solicitud en curso.
Comprobar el estado del límite de velocidad
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respuesta ilustrativa usando datos sintéticos. Los IDs, direcciones, tokens, marcas de tiempo, límites y recuentos del plan varían. Las duraciones de muestra no sobrescriben la configuración predeterminada de su plan. Las descripciones de los campos de respuesta identifican los campos que pueden ser nulos y los específicos del proveedor.

Ejemplo de respuesta
200 OK • JSON
{
    "status": "success",
    "data": {
        "limit": 60,
        "remaining": 45,
        "reset": 32,
        "plan": "premium",
        "monthly_limit": 50000,
        "monthly_remaining": 48210,
        "purchased_credits": 5000,
        "quota": {
            "enabled": true,
            "user_api_status": true,
            "plan_name": "Premium Plan",
            "period": "2026-10",
            "base_limit": 50000,
            "extra_requests": 0,
            "monthly_limit": 50000,
            "monthly_remaining": 48210,
            "used": 1790,
            "purchased_credits": 5000,
            "bonus_credits": 1000,
            "direct_purchased_credits": 4000,
            "remaining": 53210,
            "unlimited": false,
            "usage_percent": 3,
            "reset_at": "2026-11-01T00:00:00+00:00"
        }
    }
}
Campos de respuesta
Campo Tipo Descripción
data.limit integer|string
Límite de solicitudes por minuto de la cuenta. La cadena unlimited denota un presupuesto ilimitado por minuto; esto es independiente de la cuota mensual.
data.remaining integer|string
Ranuras de presupuesto de minutos restantes de la cuenta, o la cadena unlimited. Un valor positivo no significa que queden créditos de API.
data.reset integer
Segundos para la ventana de minuto de la cuenta, no el restablecimiento mensual de la cuota. Los presupuestos de minuto deshabilitados o ilimitados pueden conservar un valor nominal de 60 segundos; esto no garantiza el acceso después de esperar.
data.plan string
Etiqueta del plan actual. El nombre legible del plan se proporciona por separado en data.quota.plan_name.
data.quota.enabled boolean
Indica si el acceso global y de plan/crédito a la API está habilitado. Esto no indica la capacidad restante ni reemplaza el interruptor de API del usuario.
data.quota.user_api_status boolean
Si el usuario ha activado su interruptor de API de usuario. Las operaciones requieren este interruptor así como acceso habilitado y capacidad disponible.
data.quota.plan_name string
Nombre legible del plan actual.
data.quota.period string
Periodo de uso de calendario-mes en formato YYYY-MM, usando la zona horaria de la aplicación; no necesariamente el período de facturación de la suscripción.
data.quota.base_limit integer
Asignación base del plan mensual. Un valor de -1 significa ilimitado.
data.quota.extra_requests integer
Asignación mensual adicional concedida para el período de uso actual; separada de los créditos comprados.
data.quota.monthly_limit integer
Asignación base más solicitudes extra del período actual. Un valor de -1 significa ilimitado. Los créditos comprados no están incluidos.
data.quota.monthly_remaining integer|null
Asignación mensual finita restante, o null cuando la cuota mensual es ilimitada. Null no debe interpretarse como cero.
data.quota.used integer
Operaciones API exitosas y contabilizadas en el período de uso actual, incluidas las operaciones que usan créditos. Las verificaciones de estado no aumentan este valor.
data.quota.purchased_credits integer
Saldo actual de créditos, incluidos los créditos de bonificación del plan activo. Los créditos de bonificación no deben añadirse a este saldo una segunda vez.
data.quota.bonus_credits integer
Porción de bonificación del plan activo del saldo de créditos; un desglose de purchased_credits, no capacidad adicional.
data.quota.direct_purchased_credits integer
Saldo de crédito excluyendo la parte de bonificación del plan activo. Este valor más bonus_credits equivale a purchased_credits.
data.quota.remaining integer|null
Asignación mensual restante más el saldo de crédito actual, sin contar los bonos dos veces. Null significa cuota mensual ilimitada. Los permisos individuales de funciones y otros límites de solicitud siguen aplicando.
data.quota.unlimited boolean
Si la cuota mensual es ilimitada. Esto no hace que el presupuesto de minutos de la cuenta u otros límites de funciones sean ilimitados.
data.quota.usage_percent integer
Porcentaje redondeado compatible con el panel, de 0 a 100: usado dividido por usado más restante, multiplicado por 100. Incluye la capacidad de crédito disponible, por lo que recargar puede reducir el porcentaje. Es 0 para cuota ilimitada o un pool de tamaño cero; no es el porcentaje de límite de velocidad por minuto ni una decisión de acceso.
data.quota.reset_at string
Marca de tiempo ISO-8601 con desplazamiento de zona horaria para el próximo restablecimiento de cuota del mes calendario. Esto no es la fecha de vencimiento de la suscripción, y el restablecimiento mensual no recarga los créditos comprados.
status string
El éxito literal para este punto final de estado. Otros puntos finales de buzón exitosos usan el booleano true.
data.monthly_limit integer
Alias de compatibilidad del campo data.quota correspondiente; no lo añada de nuevo al calcular los saldos.
data.monthly_remaining integer|null
Alias de compatibilidad del campo data.quota correspondiente; no lo añada de nuevo al calcular los saldos.
data.purchased_credits integer
Alias de compatibilidad del campo data.quota correspondiente; no lo añada de nuevo al calcular los saldos.

Protección del PIN del buzón

Introduzca el PIN para continuar. Su buzón permanece desbloqueado mientras esté activo en esta sesión del sitio web.

¿Aceptas cookies?

Utilizamos cookies para mejorar tu experiencia de navegación. Al utilizar este sitio, consientes nuestra política de cookies.

Más