加载接口文档…
25
累计调用
5ms
平均响应
100.00%
服务可用性
1,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 200 次 · QPS 5
登录免费
当前方案每日 1,000 次 · QPS 20
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/2fa/raw.md接口请求地址
https://v1.apizero.cn/api/2fa
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/2fa
接口信息备注
完全免费接口。支持匿名调用（基础额度）；携带 API Key（Authorization: Bearer <key>）可获得更高额度。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| secret | string | 必填 · Base32 编码的 TOTP 密钥（自动忽略空格与连字符，不区分大小写） · 示例：JBSWY3DPEHPK3PXP |
| action | string | 可选 · 操作类型：generate=生成当前验证码 / verify=校验验证码 / batch=批量返回上一·当前·下一周期 · 默认 generate |
| code | string | 可选 · action=verify 时必填，待校验的验证码 · 示例：123456 |
| period | number | 可选 · 验证码有效期（秒），范围 10~120 · 默认 30 |
| digits | number | 可选 · 验证码位数，范围 4~8 · 默认 6 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
| Content-Type | string | 必填 · 请求体格式 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| totp_code | string | 生成的动态验证码（action=generate） |
| remaining_seconds | number | 当前验证码剩余有效秒数 |
| period | number | 验证码有效期（秒） |
| digits | number | 验证码位数 |
| timestamp | number | 服务器 Unix 时间戳（秒） |
| next_refresh | string | 下次刷新时间（YYYY-MM-DD HH:mm:ss） |
| is_valid | boolean | 校验是否通过（action=verify） |
| current_code | string | 当前正确验证码（action=verify） |
| codes | array | 上一/当前/下一周期验证码列表（action=batch） |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"totp_code": "123456",
"remaining_seconds": 17,
"period": 30,
"digits": 6,
"timestamp": 1782000000,
"next_refresh": "2026-06-30 12:00:30"
},
"request_id": "abc123",
"tips": "极数本源 · https://apizero.cn"
}