• API说明

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

    编码:UTF-8

    提交方式:GET

    注意:

    1. 本平台API不需要查询项目或申请项目,可以直接取号使用。

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

    11. 使用需注意的事项:
    12. 1.不通过API重新登录的话token不会失效。登录一次获取token后可以一直使用,不要进行频繁登录改变token,否则需要登录验证,影响正常调用。
    13. 2.参数中的汉字或特殊符号需要URL编码。
  • 创建Token

    1. 创建Token的最新方法:点击这里登录网页版,进入【个人中心】->【创建 API Token】菜单进行创建。
    2. 已废弃的创建方法:老版本创建Token的方法已废弃,请勿使用。请点击这里查看。
  • 查询余额[leftAmount]

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

    1. 调用实例:http://api./zc/data.php?code=getPhone&token=登录获取的token&keyWord=URL编码的项目关键词&phone=130xxxxxxxx&province=省份&cardType=全部
    2. 参数:
      keyWord:可选,建议填写。短信关键词,传入关键词可大大提高使用效率。如果不传入关键词,获取号码后,在收取短信时可能会收到被屏蔽的短信;
      phone:可选,指定的号码,不填的话表示随机获取号码;
      province:可选,省份,具体名称可参照APP里的;
      cardType:可选,选值范围:[实卡,虚卡,全部]。
    3. 成功返回值:手机号
    4. 失败返回值:ERROR:错误信息
    5. 备注:短信关键词一般是短信黑括号里的名字,比如【毛竹】验证码9876,keyWord是“毛竹”二字。如果没有黑括号,可以使用短信里任意一个关键的字词。
  • 获取短信[getMsg]

    1. 调用实例:http://api./zc/data.php?code=getMsg&token=登录获取的token&phone=165xxxxxxxx&keyWord=URL编码的项目关键词
    2. 参数:
      phone:获取/指定的手机号,必填;
      keyWord:短信关键词。设置不正确收不到短信,必填。
    3. 尚未收到返回值:如果包含“[尚未收到]”字样,说明尚未查询到短信。
    4. 成功返回值:短信内容
    5. 失败返回值:ERROR:错误信息
    6. 备注:短信关键词一般是短信黑括号里的名字,比如【毛竹】验证码9876,keyWord是“毛竹”二字。如果没有黑括号,可以使用短信里任意一个关键的字词。系统查询短信是查询包含这个词的短信,否则查不到。
  • 释放号码[release]

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

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

    1. 调用实例:http://api./zc/data.php?code=send&token=登录获取的token&phone=162xxxxxxxx&toPhone=1069xxxxxxxx&content=xxxx
    2. 参数:
      phone:获取/指定的手机号,用于发送短信;
      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条记录