PingMe验证码小助手API文档

欢迎使用PingMe验证码小助手API购买批量验证码:

由于PingMe验证码小助手API还属于试运行阶段,所以需要您联系我们的客服开通。

开通步骤如下:
1. 请准确填写下方表格,并点击”申请开通API”,我们的客户支持团队会收到您的申请。
2. 我们的客服人员将验证您是否符合可以打开API批量购买渠道的标准。
3. 一旦您被确认为合格用户,您的API URL将会生效。
4. 如果有任何问题请随时联系我们的客服 [email protected]

PingMe验证码小助手API文档:

获取项目列表

method:GET
headers:
accept:"application/json"
x-app-key: 开通时提供

执行以下命令后,获得项目的名字, 用作获取号码api里的参数:

curl -H 'Accept: application/json' -H 'x-app-key: key' https://api.pingme.tel/thirdparty/getAppList

获取号码

https://api.pingme.tel/thirdparty/lockNumber
method:POST
headers:
accept:"application/json"
x-app-key: 开通时提供
参数:
userId: 开通时确定
app: 需要接受验证码的app
number: 空表示拿新的,有值表示是以前用过的
锁号码成功返回:
{
  "retcode": 0,
  "retmsg": "success",
  "result": {
    "number": 16510000000,
    "price": 0.5
  }
}
锁号码失败返回:
{
  "retcode":错误码,(100000 内部错误 ,100004表示缺少参数,300002表示余额不足,500000表示没有可用号码,500001表示锁定太多号码,500002表示号码不存在或者已过期)
  "retmsg": "",
  "result": {}
}
例子:
curl -X POST -H "Content-Type:application/json" -H "accept: application/json" -H 'X-app-key:xxx' -d '{"userId":"xxx","app":"jd","number":""}' 'https://api.pingme.tel/thirdparty/lockNumber'
返回:
{
  "retcode": 0,
  "retmsg": "success",
  "result": {
    "number": "16510000000"
  }
}

订阅号码

https://api.pingme.tel/thirdparty/subNumber
method:POST
header:
accept:"application/json"
x-app-key:  开通时提供
参数:
userId: 用户id,不能为空
app:指定app 不能为空
number:需要订阅的号码,不能为空
返回:
response.type = "application/json"
response.status=403 (请求失败,没权限)
response.status=200
订阅号码成功返回:
{
   "retcode":0,
   "retmsg":"success",
   "result":{
      
   }
}
失败返回:
{
   "retcode":"错误码",(100000 内部错误 ,100004表示缺少参数,300002表示余额不足)
   "retmsg":"",
   "result":{
      
   }
}
例子:
curl -X POST -H "Content-Type:application/json" -H "accept: application/json" -H 'X-app-key:xxx' -d '{"userId":"xxx","app":"jd","number":"1xxxxxxxxxx"}' 'https://api.pingme.tel/thirdparty/subNumber'
返回:
{
   "retcode":0,
   "retmsg":"success",
   "result":{
      
   }
}

退订号码

https://api.pingme.tel/thirdparty/unSubNumber
method:POST
header:
accept:"application/json"
x-app-key:  开通时提供
参数:
userId: 用户id,不能为空
app:指定app 不能为空
number:需要退订的号码,不能为空
返回:
response.type = "application/json"
response.status=403 (请求失败,没权限)
response.status=200
退订成功返回:
{
   "retcode":0,
   "retmsg":"success",
   "result":{
      
   }
}
失败返回:
{
   "retcode":"错误码",(100000 内部错误 ,100004表示缺少参数)
   "retmsg":"",
   "result":{
      
   }
}
例子:
curl -X POST -H "Content-Type:application/json" -H "accept: application/json" -H 'X-app-key:xxx' -d '{"userId":"xxx","app":"jd","number":"1xxxxxxxxxx"}' 'https://api.pingme.tel/thirdparty/unSubNumber'
返回:
{
   "retcode":0,
   "retmsg":"success",
   "result":{
      
   }
}

获取未过期的验证码号码列表

https://api.pingme.tel/thirdparty/getNumberList
method:GET
header:
accept:"application/json"
x-app-key: 开通时提供
参数:
userId: 用户id 不能为空
app: 如果为空返回所有未过期号码,不为空获取指定app的号码
返回:
response.type="application/json"
response.status=403 (请求失败,没权限)
response.status=200
获取列表成功返回:
phone:号码
subStatus:0表示未订阅,1表示已订阅
nextPaymentDate:有效期
subRent:新订阅的月租
codeRate:短信费率
monthRent:当前月租(subStatus=1时)

{
   "retcode":0,
   "retmsg":"success",
   "result":{
      "numbers":[
         {
            "phone":"XX",
            "nextPaymentDate":"XX",
            "subStatus":"XX",
            "subRent":"XX",
            "app":"XX",
            "monthRent":"XX",
            "name":"XX",
            "telCode":"XX",
            "codeRate":"XX"
         }
      ]
   }
}
失败返回:
{
   "retcode":错误码,(100000 内部错误 ,100004表示缺少参数)
   "retmsg":"",
   "result":{
   }
}
例子:
curl -H "Content-Type:application/json" -H "accept: application/json" -H 'X-app-key:xxx' 'https://api.pingme.tel/thirdparty/getNumberList?userId=xxx&app='
返回:
{
   "retcode":0,
   "retmsg":"success",
   "result":{
      "numbers":[
         {
            "phone":"168151020115",
            "nextPaymentDate":"2021-11-22 (Expiry Date)",
            "subStatus":0,
            "subRent":"$0.5 / Month",
            "app":"jd",
            "monthRent":"",
            "name":"JD",
            "telCode":"1",
            "codeRate":"$0.2 / SMS"
         }
      ]
   }
}

短信回调 需要提前配置回调地址

method:POST
header:
Content-Type:application/json
要接收参数:
userId
app
from  app提供商的号码(有可能不是号码,是字符串)
to    接收号码
text  短信内容
time  时间
例子:
{
  "app": "jd",
  "from": "14160000000",
  "to": "16470000000",
  "userId": "xxx",
  "text": "[jd] code is 5611",
  "time": "2021-03-25T03:17:06.050Z"
}

API 申请表:

请您填写下表,以便我们可以与您联系开通。

7 + 7 =

PingMe verification code SMS

Try PingMe's Verification Code Helper

Choose from hundreds of pre-verified apps and websites to receive a verification code SMS for as low as $0.1/code.

Get Free Phone Numbers!

Join our Telegram channel to get updates on new phone numbers and other freebies. Scan the QR code or click here to join!

telegram-receive-free-sms-pingme qr code