[关闭]
@wuji 2020-04-06T11:49:43.000000Z 字数 4103 阅读 1613

qr.2-huo.com 任务平台API


平台链接:[https://qr.2-huo.com][1]




api接口说明文档

1.发布任务接口

接口:

http://api.2-huo.com/releaseQrCodeTask

  1. 提交方式:POST/GET
  2. 返回编码格式:{"code":XX,"msg":"XXX","data":"XXX"}
  3. 注:服务器运行访问间隔单设备时间为5秒以上间隔请求,请设置访问频率为5秒以上请求一次接口。否则会报错或者无返回值。
  4. GET示例: http://api.2-huo.com/releaseQrCodeTask?apiSign=密钥&region=0&taskContent=https://www.ww.ww&remark=这是一个任务备注&taskType=0

必须参数:

  1. apiSign api密钥 (必传:商家后台商家API处获得)
  2. region 任务地区 (可选) (不传自动根据ip设置地区, 获取失败则为全国 可传汉字或地区编码,编码见末尾)
  3. taskContent 任务内容 (必传) (二维码传解析过后的链接,手机号辅助传手机号,滑块辅助传获取到的链接)
  4. remark 手机号/其他 (必传) (备注标记这任务属于那个手机号)
  5. taskType 任务类型 (0:滑块辅助/二维码 1:手机号) (必传) (滑块辅助与二维码辅助传0,手机号码辅助传1

对接示例

  1. -------滑块辅助对接示例:--------
  2. http://api.2-huo.com/releaseQrCodeTask?apiSign=密钥&taskType=0&region=110000&taskContent=您获取到的滑块辅助链接&remark=此任务的手机号
  3. 注意:滑块的内容需要转码才能发布成功
  4. 转码前:https://weixin110.qq.com/security/newreadtemplate?t=signup/index&regcc=86&regmobile=16740000000&regid=3_3286581252137000000&scene=get_reg_verify_code&wechat_real_lang=zh_CN#/
  5. 转码后:https%3A%2F%2Fweixin120.qq.com%2Fsecurity%2Fnewreadtemplate%3Ft%3Dsignup%2Findex%26regcc%3D86%26regmobile%3D16740542186%26regid%3D3_3286581252137742340%26scene%3Dget_reg_verify_code%26wechat_real_lang%3Dzh_CN%23%2F
  6. -------手机号辅助对接示例:--------
  7. http://api.2-huo.com/releaseQrCodeTask?apiSign=密钥&taskType=1&region=110000&taskContent=此任务的手机号&remark=此任务的手机号
  8. -------二维码辅助对接示例:--------
  9. http://api.2-huo.com/releaseQrCodeTask?apiSign=密钥&taskType=0&region=110000&taskContent=二维码解析后的url&remark=此任务的手机号
  10. region=可以传地区编码也可以传汉字比如"北京" 110000
  11. 地区编码详情见文档末尾

返回值:

  1. --------返回值 通过判断code == 1来判断发布成功
  2. code:1 msg:"任务发布成功" data:taskUid(任务uid)
  3. --------以下值皆为异常前面是异常编码后面是异常消息
  4. code:0 msg:"操作失败,请重试/其他限制说明返回"
  5. code:2 msg:"余额不足"
  6. code:3 msg:"商家初始任务必须结算10条任务才能继续发单"
  7. code:4 msg:"API标识不能空"
  8. code:5 msg:"API标识不存在"
  9. code:6 msg:"该账号已被冻结"
  10. code:7 msg:"任务内容不能为空"
  11. code:8 msg:"任务地区错误"
  12. code:9 msg:"任务正在进行中,请勿重新发布"
  13. code:10 msg:"二维码链接错误/请输入正确手机号"

2.查询任务状态

接口:

http://api.2-huo.com/apiQueryTaskState

  1. 提交方式:POST/GET
  2. 返回编码格式:{"code":XX,"msg":"XXX","data":"XXX"}
  3. 注:服务器运行访问间隔单设备时间为5秒以上间隔请求,请设置访问频率为5秒以上请求一次接口。否则会被限制一段时间无法操作。
  4. GET示例: http://api.2-huo.com/apiQueryTaskState?apiSign=密钥&taskUid=任务uid

必须参数:

  1. apiSign api密钥 (必传)
  2. taskUid 任务uid (必传)

返回值:

  1. code:1 msg:"API标识不能空"
  2. code:2 msg:"任务uId不能为空"
  3. code:3 msg:"API标识不存在"
  4. code:4 msg:"该账号已被冻结"
  5. code:5 msg:"该任务不属于你"
  6. code:6 msg:"任务待领取"
  7. code:7 msg:"任务进行中"
  8. code:8 msg:"任务已提交,等待审核" data:"到期时间"
  9. code:9 msg:"任务已标记成功"
  10. code:10 msg:"任务已标记失败"
  11. code:11 msg:"任务已超时"
  12. code:12 msg:"任务已标记,请勿重复标记"
  13. code:-1 msg:"访问太过频繁,请一分钟后重试"

3.标记任务状态

接口:

http://api.2-huo.com/submissionTaskState

  1. 提交方式:POST/GET
  2. 返回编码格式:{"code":XX,"msg":"XXX","data":"XXX"}
  3. 注:服务器运行访问间隔单设备时间为5秒以上间隔请求,请设置访问频率为5秒以上请求一次接口。否则会被限制一段时间无法操作。
  4. GET示例: http://api.2-huo.com/submissionTaskState?apiSign=密钥&taskUid=任务uid&state=0

必须参数:

  1. apiSign api密钥 (必传)
  2. taskUid 任务uid (必传)
  3. state 任务状态(0:成功 1:失败) (必传)

返回值:

  1. code:0 msg:"操作失败,请重试"
  2. code:1 msg:"标记成功"
  3. code:2 msg:"该任务不属于你"
  4. code:3 msg:"任务未被领取或未提交完成"
  5. code:4 msg:"API标识不能空"
  6. code:5 msg:"API标识不存在"
  7. code:6 msg:"该账号已被冻结"
  8. code:7 msg:"任务已标记过,请勿重复标记"
  9. code:8 msg:"任务uId不能为空"
  10. code:9 msg:"标记任务状态必须为0或1"
  11. code:-1 msg:"访问太过频繁,请一分钟后重试"

4.获取最佳地区

接口:

http://api.2-huo.com/regionRanking

  1. **必须参数:**

apiSign api密钥 (必传)

  1. 提交方式:POST/GET
  2. 返回编码格式:{"code":XX,"msg":"XXX","data":"XXX"}
  3. GET示例: http://api.2-huo.com/regionRanking?apiSign=

返回值:

  1. code:0 msg:"API标识不能空"
  2. code:1 msg:"获取成功" data:"region:地区 regionCode:地区编码"
  3. code:2 msg:"API标识不存在"
  4. code:3 msg:"该账号已被冻结"

5.解析二维码

接口:

http://api.2-huo.com/analysisQrCode

  1. 提交方式:POST/GET
  2. 返回编码格式:{"code":XX,"msg":"XXX","data":"XXX"}
  3. 注:服务器运行访问间隔单设备时间为5秒以上间隔请求,请设置访问频率为5秒以上请求一次接口。否则会被限制一段时间无法操作。
  4. GET示例: http://api.2-huo.com/analysisQrCode?base64Data=密钥

必须参数:

  1. base64Data 图片base64

返回值:

  1. code:0 msg:"解析失败"
  2. code:1 msg:"解析成功" data:"解析内容"

地区编码

省份 编码
全国 0
未填资料(港澳台、国外) 1
北京 110000
天津 120000
河北 130000
山西 140000
内蒙古 150000
辽宁 210000
吉林 220000
黑龙江 230000
上海 310000
江苏 320000
浙江 330000
安徽 340000
福建 350000
江西 360000
山东 370000
河南 410000
湖北 420000
湖南 430000
广东 440000
广西 450000
海南 460000
重庆 500000
四川 510000
贵州 520000
云南 530000
西藏 540000
陕西 610000
甘肃 620000
青海 630000
宁夏 640000
新疆 650000
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注