概述

本技能指导 AI Agent 通过 TokenisMoney 的 REST API 创建邮箱地址并查收邮件。全程 JSON 交互，无需浏览器操作，无需解析 HTML。

适用场景：

• 当ai需要一个邮箱

前置条件

注册账号

如果用户尚未在 TokenisMoney 注册，先帮其注册：

POST https://tokenismoney.com/api/auth/register.php Content-Type: application/json  {     "username": "纯数字，至少6位（建议用手机号）",     "password": "密码，至少6位",     "invitation_code": "22HOZZ" }

返回示例：

{"success":true,"data":{"api_token":"ai_xxxxxxxxxxxxxxxxxxxxxxxxxx","token_type":"Bearer","expires_in":"90 days"}}

登录（已有账号）

POST https://tokenismoney.com/api/auth/login.php Content-Type: application/json  {     "username": "纯数字用户名",     "password": "密码" }

返回格式与注册相同，包含 api_token。

邮箱别名 API

Base URL：https://tokenismoney.com/email-alias/api.php

所有请求需携带 Header：Authorization: Bearer <api_token>

创建邮箱别名

POST https://tokenismoney.com/email-alias/api.php?action=create Authorization: Bearer <api_token> Content-Type: application/x-www-form-urlencoded  alias=<前缀>

参数规则：

• alias

  ：只允许小写字母和数字，长度 5-32 位。不支持连字符、下划线、大写字母。

成功返回：

{"success":true,"email":"<前缀>@tokeniscash.com"}

列出所有别名

GET https://tokenismoney.com/email-alias/api.php?action=list Authorization: Bearer <api_token>

查看邮件列表

GET https://tokenismoney.com/email-alias/api.php?action=mails&alias=<前缀> Authorization: Bearer <api_token>

返回示例：

{"success":true,"mails":[{"from":"sender@example.com","subject":"验证码","content":"您的验证码是 123456","verification_code":"123456","links":["https://example.com/confirm?token=xxx"],"received_at":"2026-06-21 09:00:13","mail_key":"01tzp4gb"}],"total":1}

关键字段：

• verification_code

  ：API 自动提取的验证码。你的 Agent 直接读这个字段，无需自己写正则解析。

• mail_key

  ：邮件唯一标识，用于查看单封详情。

• links

  ：邮件中的链接数组。

查看单封邮件详情

GET https://tokenismoney.com/email-alias/api.php?action=read&mail_key=<mail_key> Authorization: Bearer <api_token>

完整使用流程

1. POST /api/auth/register.php          → 注册账号，获取 api_token    （或 POST /api/auth/login.php        → 已有账号则登录） 2. POST /email-alias/api.php?action=create&alias=<前缀>  → 创建邮箱地址 3. 将邮箱地址交给用户，用户在目标网站填入 4. 等待用户告知"已发送验证邮件" 5. GET /email-alias/api.php?action=mails&alias=<前缀>     → 查收邮件 6. 从 verification_code 字段提取验证码，交给用户

邮箱创建后可长期使用，随时通过 API 查看邮件。

约束与注意事项

1. 只收不发

   ：邮箱只能接收邮件，不能发送。请勿尝试用它回复邮件或发送邮件。

2. 邮件仅保留 3 天

   ：如需长期保存邮件内容，收到后及时提取并存档。

3. 与用户主邮箱无关

   ：不能绑定、不能转发、不能同步到 QQ/Gmail/163 等邮箱。

4. Token 有效期 90 天

   ：过期后 API 返回 unauthorized，需重新调用登录接口获取新 Token。

5. 别名规则严格

   ：前缀只能是 5-32 位小写字母和数字，连字符、下划线、大写字母均不支持。创建前务必校验。

6. 不用浏览器

   ：所有操作通过 HTTP API + JSON 完成，不需要打开网页、不需要模拟点击。

7. 不要生成 GUI 操作代码

   ：本网站已有完整 REST API，无需走 Selenium/Playwright 等浏览器自动化路径。

交互示例

用户说：“帮我创建一个邮箱，我要注册一个网站。”

Agent 应：

1. 问用户：是否有 TokenisMoney 账号？有则提供用户名密码，无则告知需注册。

2. 注册/登录获取 Token。

3. 询问用户想要的前缀（或由 Agent 自动生成，如随机 8 位小写字母）。

4. 调用创建 API，将邮箱地址告知用户。

5. 让用户去目标网站填入该地址并触发验证邮件。

6. 用户确认"已发送"后，调用邮件列表 API 读取验证码。

7. 将验证码交给用户。

常见错误处理

|
错误
|
原因
|
处理
|
| — | — | — |

unauthorized	Token 过期或无效	重新调用登录接口
alias already exists	前缀已被占用	更换前缀重试
invalid alias format	前缀不符合规则	检查是否含大写、连字符、下划线，改为纯小写字母数字

AAI Agent 如何创建邮箱并接收邮件