这个风火云接码API怎么看啊

sfoxer889

API文档内容
开发者注意事项:

1.开发者无需另外注册账号，在获取验证码方法中上传一个风火云账号即可获得分成.

2.软件在每一次启动前都需登录一次获取token,任何操作都会延长token生命周期,token过期后请重新登陆获取一次即可,所以请不要在每次取号取码前都调用一次登陆,否则可能会导致账户被封.

3.发送短信超过10分钟后仍没有接到短信的号码请加黑或释放,否则会占用你可用号码数,最终可能会导致取号失败.

接口地址：http://api.sfoxer.com/api/do.php?action=

接口统一编码：UTF-8

接口调用方式： HTTP GET或POST都可以支持

GET调用方法：http://api.sfoxer.com/api/do.php?action=方法&参数=值&参数=值

返回数据：
成功统一返回 1|对应方法所需信息
失败统一返回 0|失败提示信息

以登陆接口为例:
成功返回:1|d01f7b24ebd2dc3162f66217d850ea49(其中1表示是成功了，后面的d01f7b24ebd2dc3162f66217d850ea49是api返回的token)
失败返回:0|登录失败，密码不正确(0表示失败了，"登录失败，密码不正确"是失败的原因)。

用户登陆
[方法名] loginIn

传入参数：
1.name:用户名
2.password:密码

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=loginIn&name=用户名&password=密码

方法调用返回值示例：
1.成功返回: 1|token(token是重要的返回参数，后面所有的请求都要传这个参数值)
2.失败返回: 0|错误信息

获取用户信息
[方法名] getSummary

传入参数：
1.token=登录时返回的令牌

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=getSummary&token=登录时返回的令牌

方法调用返回值示例：
1.成功返回: 1|余额|等级|批量取号数|用户类型
2.失败返回: 0|错误信息

获取手机号码
[方法名] getPhone

传入参数：
1.token=登录时返回的令牌
2.sid=项目ID(对应的项目ID可在客户端软件里查询)

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=getPhone&token=登录时返回的令牌&sid=项目ID

手机号属性可选参数：
1.size=要获取手机号数量。1<size<50
2.phone=你要指定获取的号码,传入号码不正确的情况下,获取新号码.
3.phoneType=CMCC，CMCC是指移动，UNICOM是指联通，TELECOM是指电信
4.vno=0或1，0是指排除所有虚拟运营商号码，1是只获取虚拟运营商号码
5.locationMatching、locationLevel、location三个必须一起使用。用来指定获取某个地区的号码
5.1 locationMatching=include(包含区域) 或 locationMatching=exclude(排除区域)
5.2 locationLevel=p(省份) 或 locationLevel=c(城市)
5.3 location=(要包含或排除的省份或城市,该值对应locationLevel)
5.4 locationMatching、locationLevel、location三个必须一起使用。用来指定取某些区域的手机号或者不要某些区域的手机号
特别注意:
locationMatching的参数值只能是include或者exclude中的一个。
include指的是包含区域，exclude指的是不包含区域
locationLevel参数只能是p或者c中的一个。p指的是省（province），c指的是市（city）
location指的是具体地区，中文值。需要UrlEncode编码 例：湖南编码后的值为 u%e6%b9%96%e5%8d%97

GET方式调用实例(指定地区调用):
http://api.sfoxer.com/api/do.php?action=getPhone&sid=项目ID&token=登录时返回的令牌 &locationMatching=include&locationLevel=p&location=u%e6%b9%96%e5%8d%97

方法调用返回值示例：
1.成功返回: 1|获取到的手机号(size大于1时,手机号以英文逗号分隔)
2.失败返回: 0|错误信息

获取验证码
[方法名] getMessage

说明：
1.使用该方法获得验证码后，系统自动会释放该号码,不用重复加黑或释放操作了
2.因部分短信可能延迟，所以建议该方法每5秒调用一次，调用300秒

传入参数：
1.token=登录时返回的令牌
2.sid=获取此号码时指定的项目ID
3.phone=通过getPhone方法获取到的手机号
3.author=开发者用户名(可选,这里是传开发者注册时的用户名)

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=getMessage&token=登录时返回的令牌&sid=项目id&phone=取出来的手机号

方法调用返回值示例：
1.成功返回: 1|短信内容
2.失败返回: 0|没有短信的提示或其它错误信息

加黑手机号
[方法名] addBlacklist

说明：
1.此功能只适用于没有取到短信的手机号,取到短信后系统会自动释放,不用调用此方法

传入参数：
1.token=登录时返回的令牌
2.sid=获取此号码时指定的项目ID
3.phone=通过getPhone方法获取到的手机号
3.author=开发者用户名(可选,这里是传开发者注册时的用户名)

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=addBlacklist&token=登录时返回的令牌&sid=项目ID&phone=取出来的手机号

方法调用返回值示例：
1.成功返回: 1|短信内容
2.失败返回: 0|没有短信的提示或其它错误信息

释放指定手机号
[方法名] cancelRecv

说明：
1.调用该方法可能会导致获取到重复的号码,请酌情使用.
2.如果手机号没有收到短信,可调用addBlacklist加黑手机号.

传入参数：
1.token=登录时返回的令牌
2.sid=获取此号码时指定的项目ID
3.phone=通过getPhone方法获取到的手机号

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=cancelRecv&token=登录时返回的令牌&sid=项目ID&phone=要释放的手机号

方法调用返回值示例：
1.成功返回: 1|操作成功
2.失败返回: 0|错误信息

释放全部已获取手机号
[方法名] cancelAllRecv

说明：
1.调用该方法会释放用户下所有已获取的号码,多个客户端同时使用的客户请酌情使用.

传入参数：
1.token=登录时返回的令牌

GET方式调用示例：http://api.sfoxer.com/api/do.php?action=cancelAllRecv&token=登录时返回的令牌

方法调用返回值示例：
1.成功返回: 1|操作成功
2.失败返回: 0|错误信息