• API说明(通道2)

    基础地址:http://api./zc/data.php

    编码:UTF-8

    提交方式:GET

    注意:

    1. 注意封号风险:如果同一账户多次查询项目或取号后并没有收取到短信, 系统会视为非正常操作或违规操作,会对用户使用通道2的权限进行限制。

    2. API支持以下功能:
    3. 1.登录
    4. 2.查询余额
    5. 3.查询项目
    6. 4.取号
    7. 5.取码
    8. 6.释放
    9. 7.拉黑
    10. 8.发送短信
    11. 9.查询历史记录

    12. 使用需注意的事项:
    13. 1.不通过API重新登录的话token不会失效
    14. 2.参数中的汉字或特殊符号需要URL编码。
    15. 3.使用不了的号码进行拉黑处理。
  • 登录[login]

    1. 调用实例:http://api./zc/data.php?code=login&user=用户名&password=密码
    2. 成功返回值:token
    3. 失败返回值:ERROR:错误信息
    4. 备注:登录一次获取token后,token长期有效,不重新登录token不会改变。
  • 查询余额[leftAmount]

    1. 调用实例:http://api./zc/data.php?code=leftAmount&token=登录获取的token
    2. 成功返回值:余额
    3. 失败返回值:ERROR:错误信息
    4. 备注:无
  • 查询项目[queryProjs]

    1. 调用实例:http://api./zc/data.php?code=queryProjs&token=登录获取的token&proj=%E7%9F%A5%E4%B9%8E
    2. 参数:proj:项目名称或项目id
    3. 成功返回值:项目列表,多个项目信息之间是以换行符‘\n’分隔的。
      每一个项目内部信息项分别是:项目id、价格、项目名称、卡类型、收发类型,各项之间以制表符‘\t’分隔。
    4. 失败返回值:ERROR:错误信息
    5. 备注:项目名称一般是验证码短信黑括号里的名字,比如【毛竹】验证码9876,则proj就是“毛竹”二字。如果没有黑括号,可以自己试着搜索其他相关的关键词。返回的项目id可以是0,如果返回0的话后续操作也和非0时的情况一样使用。
  • 获取号码[getPhone]

    1. 调用实例:http://api./zc/data.php?code=getPhone&token=登录获取的token&projId=10056&phone=130xxxxxxxx&province=宁夏&cardType=全部
    2. 参数:
      projId:调用查询项目接口返回的项目ID;如果查询项目时返回的为0,此处直接传入0就可以了;
      phone:可选,指定的号码,不填的话表示随机获取号码;
      province:可选,省份,具体名称可参照APP里的;
      cardType:可选,选值范围:[实卡,虚卡,全部];
    3. 成功返回值:手机号
    4. 失败返回值:ERROR:错误信息
    5. 备注:无
  • 获取短信[getMsg]

    1. 调用实例:http://api./zc/data.php?code=getMsg&token=登录获取的token&phone=165xxxxxxxx&projId=10056
    2. 参数:
      phone:获取/指定的手机号;如果是指定手机号,不能直接在此处指定,要先指定号码请求一次[getPhone]接口才能调用此接口。
      projId:项目ID;如果查询项目时返回的为0,直接传入0就可以了。
    3. 尚未收到返回值:如果包含“[尚未收到]”字样,说明尚未查询到短信。
    4. 成功返回值:短信内容
    5. 失败返回值:ERROR:错误信息
  • 释放号码[release]

    1. 调用实例:http://api./zc/data.php?code=release&token=登录获取的token&phone=162xxxxxxxx&projId=10056
    2. 参数:
      phone:获取/指定的手机号;
      projId:项目ID;
    3. 成功返回值:释放结果
    4. 失败返回值:ERROR:错误信息
    5. 备注:如果释放失败无需一直重复释放。
  • 拉黑号码[block]

    1. 调用实例:http://api./zc/data.php?code=block&token=登录获取的token&phone=162xxxxxxxx&projId=10056
    2. 参数:
      phone:获取/指定的手机号;
      projId:项目ID;
    3. 成功返回值:拉黑结果
    4. 失败返回值:ERROR:错误信息
    5. 备注:如果拉黑失败无需一直重复拉黑。
  • 发送短信[send]

    1. 调用实例:http://api./zc/data.php?code=send&token=登录获取的token&phone=162xxxxxxxx&toPhone=1069xxxxxxxx&projId=10056&content=xxxx
    2. 参数:
      phone:获取/指定的手机号,用于发送短信;如果是指定手机号,不能直接在此处指定,要先指定号码请求一次[getPhone]接口才能调用此接口。
      toPhone:要发送到的号码;
      projId:项目ID;
      content:发送内容;
    3. 成功返回值:发送结果
    4. 失败返回值:ERROR:错误信息
    5. 备注:不能向个人手机号发送信息,发送垃圾信息会被封号。
  • 查询历史记录[queryUsed]

    1. 说明:每分钟调用次数不能超过一次,否则系统会封禁账号的API调用。
    2. 调用实例:http://api./zc/data.php?code=queryUsed&token=登录获取的token
    3. 参数:token:登录获取的token
    4. 成功返回值:历史记录,每条以换行符(\n)分割。
    5. 失败返回值:ERROR:错误信息
    6. 备注:返回最近24小时100条记录