2FA 动态验证码

API

2FA 动态验证码（TOTP）生成与校验，兼容 Google Authenticator 等主流身份验证器。基于 RFC 6238 标准由本平台自建实现，支持「生成 / 验证 / 批量」三种模式，可自定义验证码位数（4~8）与有效周期（10~120 秒）。密钥仅参与计算、不存储…

接入文档

由极数本源提供·更新于今天

先试用，再接接口

不用写代码。打开工具页跑一遍 2FA 动态验证码，看清结果再来订阅。

打开2FA 动态验证码

累计调用

4ms

平均响应

100.00%

服务可用性

1,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 3

今日已用 … / 1,000 次/日…

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每日 200 次 · QPS 2

登录免费

当前方案

每日 1,000 次 · QPS 3

黄金会员

每日 50,000 次 · QPS 10

钻石会员

每日 100,000 次 · QPS 30

企业会员

企业接口额度 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/2fa/raw.md

打开文档

接入文档

打开

在线工具

打开2FA 动态验证码

接口请求地址

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）

codes[]

string

备用码

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"
}

加载接口文档…

名称

类型

说明

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

必填 · 请求体格式

{ "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" }