diff --git a/%E7%BB%88%E7%AB%AF%E6%9C%BA%E5%95%86%E5%AE%B6.md b/%E7%BB%88%E7%AB%AF%E6%9C%BA%E5%95%86%E5%AE%B6.md index 3bdc3b5..7bf555c 100644 --- a/%E7%BB%88%E7%AB%AF%E6%9C%BA%E5%95%86%E5%AE%B6.md +++ b/%E7%BB%88%E7%AB%AF%E6%9C%BA%E5%95%86%E5%AE%B6.md @@ -14,16 +14,14 @@ ### 获取手机号 -接口文档 - 接口地址: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 @@ ### 获取验证码 -接口文档 - 此步骤需要多次尝试,建议设定请求间隔为5s,持续5min 接口地址:https://api.code92.top/api/adm/sms.code/get @@ -97,12 +93,70 @@ ### 报告验证码错误 -如您收到验证码输入目标程序后提示验证码不正确,可调用此接口(文档)上报,将该次任务状态重置为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多次未获取到验证码,需要放弃此号继续做下一个任务时,请调用此接口(文档),释放手机号之后即停止计费,避免损耗。 +如果调用步骤2多次未获取到验证码,需要放弃此号继续做下一个任务时,请调用释放手机号接口,释放手机号之后即停止计费,避免损耗。 + +接口地址:https://api.code92.top/api/adm/sms.code/release.phone + + +请求示例(POST): + +``` json +{ + "id": 611987201483781 // 业务流水号 +} +``` + +响应示例: + +``` json +{ + "code": "succeed", + "data": 1 +} +``` ### 拉黑手机号 -如果不希望获取到某个手机号,可以调用此接口(文档)拉黑,拉黑之后可确保24小时内不会再次取到此手机号。 +如果不希望获取到某个手机号,可以调用手机号拉黑接口,拉黑之后可确保24小时内不会再次取到此手机号。 + +接口地址:https://api.code92.top/api/adm/sms.code/ban.phone + + +请求示例(POST): + +``` json +{ + "id": 611987201483781 // 业务流水号 +} +``` + +响应示例: + +``` json +{ + "code": "succeed", + "data": 1 +} +```