更新 Home

tk 2024-07-31 18:51:57 +08:00
parent 8bcbd41613
commit 256327e783

53
Home.md

@ -5,23 +5,23 @@
## 商家 API 接口 根地址
正式环境:<a href="http://api.cc.line92.xyz" target="_blank">http://api.cc.line92.xyz</a>
正式环境:<a href="https://api.code92.top" target="_blank">https://api.code92.top</a>
测试环境:<a href="http://test-api.cc.line92.xyz" target="_blank">http://test-api.cc.line92.xyz</a>
测试环境:<a href="https://test-api.code92.top" target="_blank">https://test-api.code92.top</a>
## 阅读 API 功能文档
<a href="http://test-api.cc.line92.xyz" target="_blank">http://test-api.cc.line92.xyz</a>
<a href="https://test-api.code92.top" target="_blank">https://test-api.code92.top</a>
## 商家身份鉴权
几乎所有的 API 都要求验证权限,请在 HTTP 请求头中添加您账号的 JWT Token
- Header KeyAuthorization
- Header ValueXXXXXXXXXXX <a href="http://admin.cc.line92.xyz/profile/merchant" target="_blank">查看商家授权令牌</a>
- Header ValueXXXXXXXXXXX <a href="https://admin.code92.top/profile/merchant" target="_blank">查看商家授权令牌</a>
## 短信接码流程
1. 获取手机号(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-get.phone-Post" target="_blank">文档</a>
1. 获取手机号(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-get.phone-Post" target="_blank">文档</a>
成功响应示例:
``` json
@ -43,37 +43,10 @@
}
```
获取手机号外部错误表
| 火狐狸(1)、低了一(9)、推码(5)、沃玛(7) | 导入号(8) | 卡库(4) | 爱接码(1) | 蛇码(11) | 爱凯一(12) | 爱凯二(13) | 铁头(14) | 榴莲(15) | 阿九(16) | 远山(17) | 摩洛哥(18) |
| - | - | - | - | - | - | - | - | - | - | - | - |
| -1 | | | | | | | | | | | |
| 暂时无号 | | | | | | | | | | | |
| -2 | | | | | | | | | | | |
| Token不存在 | | | | | | | | | | | |
| -3 | | | | | | | | | | | |
| 项目ID不存在 | | | | | | | | | | | |
| -4 | | | | | | | | | | | |
| 国家代码有误 | | | | | | | | | | | |
| -5 | | | | | | | | | | | |
| 项目未审核 | | | | | | | | | | | |
| -6 | | | | | | | | | | | |
| 项目已禁用 | | | | | | | | | | | |
| -7 | | | | | | | | | | | |
| 用户已禁用 | | | | | | | | | | | |
| -8 | | | | | | | | | | | |
| 余额不足,请充值 | | | | | | | | | | | |
| -9 | | | | | | | | | | | |
| 占号过多,请补充余额 | | | | | | | | | | | |
| -10 | | | | | | | | | | | |
| 项目不允许指定取号 | | | | | | | | | | | |
2. 拿到手机号输入目标程序发送验证码
3. 获取验证码(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-get-Post" target="_blank">文档</a>此步骤需要多次尝试建议设定请求间隔为5s持续5min
3. 获取验证码(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-get-Post" target="_blank">文档</a>此步骤需要多次尝试建议设定请求间隔为5s持续5min
取到码响应示例:
``` json
@ -106,16 +79,16 @@
```
### 报告验证码错误
如您收到验证码输入目标程序后提示验证码不正确,可调用此接口(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-report.sms.code.error-Post" target="_blank">文档</a>上报将该次任务状态重置为waiting 之后继续执行步骤3直到状态为received即收到了新的正确的验证码。
如您收到验证码输入目标程序后提示验证码不正确,可调用此接口(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-report.sms.code.error-Post" target="_blank">文档</a>上报将该次任务状态重置为waiting 之后继续执行步骤3直到状态为received即收到了新的正确的验证码。
### 释放手机号
如果调用步骤2多次未获取到验证码需要放弃此号继续做下一个任务时请调用此接口<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-release.phone-Post" target="_blank">文档</a>),释放手机号之后即停止计费,避免损耗。
如果调用步骤2多次未获取到验证码需要放弃此号继续做下一个任务时请调用此接口<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-release.phone-Post" target="_blank">文档</a>),释放手机号之后即停止计费,避免损耗。
### 拉黑手机号
如果不希望获取到某个手机号,可以调用此接口(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-ban.phone-Post" target="_blank">文档</a>拉黑拉黑之后可确保24小时内不会再次取到此手机号。
如果不希望获取到某个手机号,可以调用此接口(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/sms.code/api-adm-sms.code-ban.phone-Post" target="_blank">文档</a>拉黑拉黑之后可确保24小时内不会再次取到此手机号。
## 邮箱接码流程
1. 获取邮箱号(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-get.email-Post" target="_blank">文档</a>
1. 获取邮箱号(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-get.email-Post" target="_blank">文档</a>
成功响应示例:
``` json
@ -136,7 +109,7 @@
}
```
2. 拿到邮箱号输入目标程序发送验证码
3. 获取邮件码(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-get-Post" target="_blank">文档</a>此步骤需要多次尝试建议设定请求间隔为5s持续5min
3. 获取邮件码(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-get-Post" target="_blank">文档</a>此步骤需要多次尝试建议设定请求间隔为5s持续5min
取到码响应示例:
``` json
@ -169,7 +142,7 @@
```
### 报告验证码错误
如您收到验证码输入目标程序后提示验证码不正确,可调用此接口(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-ban.email-Post" target="_blank">文档</a>上报将该次任务状态重置为waiting 之后继续执行步骤3直到状态为received即收到了新的正确的验证码。
如您收到验证码输入目标程序后提示验证码不正确,可调用此接口(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-ban.email-Post" target="_blank">文档</a>上报将该次任务状态重置为waiting 之后继续执行步骤3直到状态为received即收到了新的正确的验证码。
### 拉黑邮箱号
如果不希望获取到某个邮箱号,可以调用此接口(<a href="http://test-api.cc.line92.xyz/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-report.mail.code.error-Post" target="_blank">文档</a>拉黑拉黑之后可确保24小时内不会再次取到此邮箱号。
如果不希望获取到某个邮箱号,可以调用此接口(<a href="https://test-api.code92.top/index.html#/%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1/mail.code/api-adm-mail.code-report.mail.code.error-Post" target="_blank">文档</a>拉黑拉黑之后可确保24小时内不会再次取到此邮箱号。