收件箱

每个邮箱只显示添加后收到的最新一封邮件。

	邮箱	提取结果	接收时间	分组

邮箱管理

只能添加管理员已生成的 @outkl.com 邮箱。

添加邮箱

新建分组

批量导入与导出

支持 CSV/TXT，每行仅需一个邮箱地址，最多 10,000 行。

	邮箱	原分组	自动清理时间

兑换中心

兑换码绑定当前账户后，可以按需要分批提取邮箱。

API Key

每个账户最多 5 条有效 Key，每条 Key 可授权一个或多个分组。

创建 API Key

API Key

开发者中心

查看请求格式、认证方式以及可直接运行的接入示例。

认证方式

邮箱领取、批次状态与提取结果增量查询接口需要在请求头中携带 API Key。单邮箱公开链接无需认证。

Authorization: Bearer outkl_live_YOUR_API_KEY

请仅在服务端保存 API Key，不要写入网页或客户端代码。

统一响应格式

成功时返回 JSON；邮箱暂无可提取结果时返回 204 空响应。

{ "code": "aB7k21" }

GET/api/v1/code/{email}公开接口 · 无需 API Key

读取指定邮箱最新一封邮件正文的结构化提取结果。接口不受账户和分组影响，响应仅包含 code 字段。

单邮箱公开链接
https://outkl.com/api/v1/code/username@outkl.com

请求参数

字段	位置	类型	必填	说明
email	路径	string	是	完整邮箱地址，例如 username@outkl.com

请求示例

curl "https://outkl.com/api/v1/code/username@outkl.com"

响应示例 · 200 OK

{ "code": "aB7k21" }

POST/api/v1/mailboxes/claim需要 API Key

按照 API Key 的分组优先级和邮箱加入顺序领取邮箱。同一用户账户下所有 API Key 共用去重记录，已经领取的邮箱不会再次分配。

请求参数

字段	位置	类型	必填	说明
count	JSON	integer	是	领取数量，1–500；邮箱不足时整批失败
request_id	JSON	string	是	调用端生成的幂等编号；重试相同编号返回原批次

请求示例

curl -X POST \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -H "Content-Type: application/json" \ -d '{"count":2,"request_id":"batch-20260815-001"}' \ "https://outkl.com/api/v1/mailboxes/claim"

响应示例 · 200 OK

{ "batch_id": "1ad8d492-56b0-4b7f-b10a-7df0da1b90d1", "request_id": "batch-20260815-001", "requested_count": 2, "items": [ { "slot": 1, "claim_id": "f1ab9a30-0940-43f4-9d71-e795894219ad", "email": "abc123@outkl.com", "username": "abc123", "code": null, "status": "waiting" } ] }

GET/api/v1/mailboxes/claims/{batch_id}需要 API Key

查看领取批次内全部邮箱的处理状态。仅当领取后出现新邮件且正文提取成功时，状态才变为 ready，从而避免返回领取前的历史结果。

请求示例

curl -H "Authorization: Bearer <YOUR_API_KEY>" \ "https://outkl.com/api/v1/mailboxes/claims/1ad8d492-56b0-4b7f-b10a-7df0da1b90d1"

响应示例 · 200 OK

{ "batch_id": "1ad8d492-56b0-4b7f-b10a-7df0da1b90d1", "items": [ { "slot": 1, "email": "abc123@outkl.com", "username": "abc123", "code": "aB7k21", "status": "ready", "revision": 129 } ] }

GET/api/v1/mailboxes/claims/changes?batch_id=&cursor=需要 API Key

按照邮件版本升序返回已领取邮箱的新结构化提取结果。每条记录包含原始 slot、claim_id、完整邮箱和用户名，接入程序应使用这些字段关联原始输入位置。

请求参数

字段	位置	类型	必填	说明
batch_id	查询	UUID	否	指定批次；留空读取该 Key 的全部领取记录
cursor	查询	string	否	首次留空，之后原样传回响应游标
limit	查询	integer	否	每次返回数量，默认 100，最大 500

请求示例

curl -H "Authorization: Bearer <YOUR_API_KEY>" \ "https://outkl.com/api/v1/mailboxes/claims/changes?batch_id=1ad8d492-56b0-4b7f-b10a-7df0da1b90d1"

响应示例 · 200 OK

{ "cursor": "MTI5", "items": [ { "batch_id": "1ad8d492-56b0-4b7f-b10a-7df0da1b90d1", "slot": 1, "claim_id": "f1ab9a30-0940-43f4-9d71-e795894219ad", "email": "abc123@outkl.com", "username": "abc123", "code": "aB7k21", "status": "ready", "revision": 129 } ] }

GET/api/v1/codes/changes?cursor=&limit=100兼容接口

按 API Key 已授权分组读取全部邮箱变化。新的接入程序建议使用邮箱领取接口，避免重复使用邮箱。

请求参数

字段	位置	类型	必填	说明
cursor	查询	string	否	首次留空，之后原样传回响应游标
limit	查询	integer	否	每次返回数量，默认 100

请求示例

curl -H "Authorization: Bearer <YOUR_API_KEY>" \ "https://outkl.com/api/v1/codes/changes?limit=100"

响应示例 · 200 OK

{ "cursor": "MTI4", "items": [ {"email":"username@outkl.com","username":"username","code":"aB7k21","revision":128} ] }

响应状态

200请求成功
204公开单邮箱存在，但暂无可提取结果
400request_id、游标或请求参数无效
401API Key 无效、已撤销或已重置
404邮箱或领取批次不可用
409授权分组内未领取邮箱数量不足
429请求频率超限，请按 Retry-After 重试

Python 领取示例

import requests headers = {"Authorization": "Bearer <YOUR_API_KEY>"} batch = requests.post( "https://outkl.com/api/v1/mailboxes/claim", headers=headers, json={"count": 10, "request_id": "job-20260815-001"}, timeout=15, ).json() for item in batch["items"]: print(item["slot"], item["email"]) changes = requests.get( "https://outkl.com/api/v1/mailboxes/claims/changes", headers=headers, params={"batch_id": batch["batch_id"]}, timeout=15, ) for item in changes.json()["items"]: print(item["slot"], item["email"], item["code"])

在线 API 测试

输入完整邮箱地址即可测试。请求不携带 API Key，不受账户或分组影响。

等待测试

安全设置

修改密码会注销当前设备以外的全部登录会话。

Outkl

收件箱

邮箱管理

添加邮箱

新建分组

批量导入与导出

兑换中心

API Key

创建 API Key

API Key

开发者中心

认证方式

统一响应格式

请求参数

请求示例

响应示例 · 200 OK

请求参数

请求示例

响应示例 · 200 OK

请求示例

响应示例 · 200 OK

请求参数

请求示例

响应示例 · 200 OK

请求参数

请求示例

响应示例 · 200 OK

响应状态

Python 领取示例

在线 API 测试

安全设置

修改密码

登录设备

Outkl

收件箱

邮箱管理

添加邮箱

新建分组

批量导入与导出

回收站

兑换中心

API Key

创建 API Key

API Key

开发者中心

认证方式

统一响应格式

请求参数

请求示例

响应示例 · 200 OK

请求参数

请求示例

响应示例 · 200 OK

请求示例

响应示例 · 200 OK

请求参数

请求示例

响应示例 · 200 OK

请求参数

请求示例

响应示例 · 200 OK

响应状态

Python 领取示例

在线 API 测试

安全设置

修改密码

登录设备