更新 终端机商家

tk 2024-11-22 10:51:19 +08:00
parent 02c5d8058a
commit 8e5176e475

@ -14,16 +14,14 @@
### 获取手机号
<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>
接口地址https://api.code92.top/api/adm/sms.code/get.phone
请求示例(POST)
``` json
{
"project": "telegram",
"project": "telegram", // 接码项目,可选值:见本页底部项目表
"provider": "terminal", // 此项固定不可变
"countryCode": "us"
"countryCode": "us" // 获取指定国家的手机号(两位国家编码),可选值:见本页底部国家代码表
}
```
@ -32,9 +30,9 @@
{
"code": "succeed", // 使用if ( code == "succeed" ) 判定获取成功。
"data": {
"callingCode": 66, // 国际电联ITU-T E.164 callingcodes https://www.itu.int/dms_pub/itu-t/opb/sp/T-SP-E.164D-11-2011-PDF-E.pdf
"callingCode": 66, // 国际电话区号
"id": 552149995081733, // 业务流水号,存下来,在后续的接口调用中要传入。
"phoneNumber": "858683974" // 去除callingCode前缀的电话号码
"phoneNumber": "858683974" // 不带区号的电话号码
}
}
```
@ -51,8 +49,6 @@
### 获取验证码
<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
接口地址https://api.code92.top/api/adm/sms.code/get
@ -97,12 +93,70 @@
### 报告验证码错误
如您收到验证码输入目标程序后提示验证码不正确,可调用此接口(<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即收到了新的正确的验证码。
如您收到验证码输入目标程序后提示验证码不正确可调用错误上报接口将该次任务状态重置为waiting 之后继续执行步骤3直到状态为received即收到了新的正确的验证码。
接口地址https://api.code92.top/api/adm/sms.code/report.sms.code.error
请求示例(POST)
``` json
{
"id": 611987201483781 // 业务流水号
}
```
响应示例:
``` json
{
"code": "succeed",
"data": 1
}
```
### 释放手机号
如果调用步骤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>),释放手机号之后即停止计费,避免损耗。
如果调用步骤2多次未获取到验证码需要放弃此号继续做下一个任务时请调用释放手机号接口释放手机号之后即停止计费避免损耗。
接口地址https://api.code92.top/api/adm/sms.code/release.phone
请求示例(POST)
``` json
{
"id": 611987201483781 // 业务流水号
}
```
响应示例:
``` json
{
"code": "succeed",
"data": 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-ban.phone-Post" target="_blank">文档</a>拉黑拉黑之后可确保24小时内不会再次取到此手机号。
如果不希望获取到某个手机号可以调用手机号拉黑接口拉黑之后可确保24小时内不会再次取到此手机号。
接口地址https://api.code92.top/api/adm/sms.code/ban.phone
请求示例(POST)
``` json
{
"id": 611987201483781 // 业务流水号
}
```
响应示例:
``` json
{
"code": "succeed",
"data": 1
}
```