FOTP接口文档
OTP-API
业务流程图
推送消息 模式流程
拉取消息 模式流程
接口
公共请求头
接口用户认证采用请求头sign认证,具体可参考 OTP接口文档-V1.0 2.1 公共请求头。
获取上行验证跳转链接
接口地址: /flash/opt/verify
请求方式:POST
请求数据类型:application/json
请求示例:
{"ftId":"2"}
请求参数:
参数名称 | 数据类型 | 是否必填 | 描述 |
---|---|---|---|
ftId | String | 必填 | FOTP 模版 ID(Flash OTP Template 页面 FOTP ID) |
code | String | 非必填 | 验证码 4-6位 默认使用创蓝生成的4位验证码 |
validityPeriod | String | 非必填 | 验证码有效期 最长10分钟 默认5分钟,过期后跳转链接将不可用 |
响应状态:
状态码 | 说明 | schema |
---|---|---|
000000 | OK |
响应参数:
参数名称 | 数据类型 | 描述 |
---|---|---|
code | String | |
message | String | |
data | ||
url | String | 跳转链接 |
messageId | String | 消息ID |
ftToken | String | FOTP令牌 |
code | String | 验证码 |
响应示例:
{
"code": "000000",
"success": true,
"message": "请求成功",
"data": {
"messageId": "393801984179642368",
"url": "http://otpdev.cm253.com/otp-api/flash/opt/redirect/200e96b6a8bf8ed8c3de194cf14b342f",
"ftToken": "200e96b6a8bf8ed8c3de194cf14b342f",
"code": "3872"
}
}
Callingback Address 回调地址(推送消息)
Flash OTP Template 页面配置的 Callingback Address 地址
请求参数:
参数名称 | 数据类型 | 是否必填 | 描述 |
---|---|---|---|
mobile | String | 必填 | 手机号 |
sender | String | 必填 | 发送号码 |
sendTime | String | 必填 | 发送时间 |
code | String | 必填 | 验证码 |
content | String | 非必填 | 上行内容 |
deliverTime | String | 非必填 | 上行时间 |
err | String | 非必填 | 异常原因 |
请求示例
{
"sendTime": "2025-05-15 11:23:34",
"code": "5776",
"sender": "1008611",
"mobile": "8615711666132",
"content": "🔐 Exclusive Access Unlocked!\nYour VIP Key: ##FG5x-5776##\n🚀 How to Redeem:\n1️⃣ Copy this entire message\n2️⃣ Open [App Name] and paste it\n3️⃣ Unlock premium content/features instantly!",
"deliverTime": "2025-05-15 11:24:24"
}
响应参数
参数名称 | 类型 | 参数说明 |
---|---|---|
code | String | 0 成功 其他均为失败 |
响应示例:
{
"code": "0"
}
查询上行结果(拉取消息)
接口地址: /flash/opt/query
请求方式:POST
请求数据类型:application/json
请求示例:
{"ftToken": "44cadc6071214b968b3b3bb1cb5a6c24"}
参数名称 | 数据类型 | 是否必填 | 描述 |
---|---|---|---|
ftToken | String | 必填 | FOTP令牌 |
响应示例:
{
"code": "000000",
"success": true,
"message": "请求成功",
"data": {
"status": "2",
"mobile": "6285273203675",
"sender": "6285215410016",
"sendTime": "2025-04-29 17:47:00",
"code": "5777",
"deliverTime": "2025-04-29 17:48:23"
}
}
参数名称 | 类型 | 参数说明 |
---|---|---|
status | String | 状态 0 处理中 1 失败 2 成功 |
mobile | String | 手机号 |
sender | String | 发送号码 |
sendTime | String | 发送时间 |
deliverTime | String | 上行时间 |
code | String | 验证码 |
Updated 3 days ago