NiMail临时邮箱API对接文档

Posted by

第一步:随机邮箱

邮箱规则可以自己定义,可以随机数作为前缀接@longzg.cn,随机字符串只能是英文字母和数字。

如:yeor2hwi@nimail.cnijqtrrd4@nimail.cn

第二步:申请这个邮箱

将上面的邮箱作为参数,传到接口里面去。请注意,申请邮箱接口是免费的,不传Basic授权码则是共享访问,并发量大会受到限制,且没有技术支持。

接口POST请求示例:

curl 'https://www.nimail.cn/api/applymail' \
-H 'Accept: application/json' \
-H 'Authorization: Basic xxxxxxxxxxxxx' \
-H 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8' \
--data-raw 'mail=yeor2hwi@nimail.cn'

接口响应示例:

{
  "delay": "10:00",
  "tips": "",
  "user": "yeor2hwi@nimail.cn",
  "success": "true",
  "time": 1778673597
}

接口调用后,会有10分钟的有效时间,10分钟内收到的邮件能查得到,超出10分钟则会被清除掉。

第三步:监听邮件

申请完邮箱需要监听和查询这个邮箱是否收到邮件,直接轮询调用下面的接口,就可以查询10分钟内的邮件。接口会返回整个10分钟内的邮件列表,请过滤筛选目标邮件,进行查询详情。

接口POST请求示例:

curl 'https://www.nimail.cn/api/getmails' \
-H 'Accept: application/json' \
-H 'Authorization: Basic xxxxxxxxxxxxx' \
-H 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8' \
--data-raw 'mail=yeor2hwi@nimail.cn&time=0&_=1778673604409'

接口响应示例:

{
  "to": "ijqtrrd4@nimail.cn",
  "mail": [
    {
      "subject": "验证码",
      "id": "1778675485493",
      "email": "ijqtrrd4@nimail.cn",
      "from": ""account@nimail.ai "<account@mail.nimail.ai >",
      "reply-to": "support@nimail.ai",
      "cc": "",
      "md5": "66c625dd55b7e02d7aa09f5d6e9d8ec6",
      "mail-len": 7248,
      "attachments": [],
      "time": "2026-05-13 20:31:25"
    }
  ],
  "success": "true",
  "time": 1778675503
}

第四步:查询邮件详情

根据监听查询邮件列表接口返回的数据,可以查询某个邮件的详情内容,接口请求如下:

接口GET请求示例:

curl 'https://www.nimail.cn/api/raw-html/ijqtrrd4@nimail.cn/1778675485493' \
-H 'Authorization: Basic xxxxxxxxxxxxx' 

接口响应示例:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body style="padding: 0; margin: 0;">
...

返回的是邮件内容,如果是验证码需求,请根据邮件内容来进行正则匹配验证码。

产品演示:

https://www.nimail.cn