挖米啦广告直链网站对接文档.v3.0.docVIP

挖米啦广告直链网站主对接文档 平台使用接口说明 项目负责：挖米啦项目组 2015-07-20 挖米啦项目组 文档编号 编撰人 WML-AGUSEV1.0/0028. 张建辉 平台使用接口说明 共4页 最后更新　20-10-10 规范约定 1.1、双方约定请求数据 传输格式如下： [接口URL]?[参数名称1]=[参数值1] [参数名称2]=[参数值2] 其中[参数名称1]表示要传递参数的名称, [参数值1]表示要传递的参数的值。 例如“ad_user=wml”中，ad_user就相当于[参数名称1]，而wml就相当于[参数值1] 如果请求的[参数值]中包括其他特殊字符, 如, ?, =，等，请使用URLENCODE编码规则 1.2、挖米啦提供的接口中wid（即贵平台在挖米啦的标识）值都固定的，查询到的wid，可以写在固定的地方供调用，在合作过程中wid是不会改变的。 任务信息查询 任务详细信息（包括奖励数量，任务替换，接口URL）在网站主后台【广告维护】功能通【查询】获得。 任务跳转URL 直链跳转URL，即跳转到商家的链接。 URL通过网站主后台站点【查看/编辑】中获得。 URL示例： /jump?wid=1type=registertid=318f233fc957213333c197sign=b9a8c9e06e923cb08e2abfd5dfa2761fuserid=123456wtid=1 参数说明： 请求参数 说明 必填 示例值 userid 贵平台用户ID 替换贵网站登录用户ID 是 123456 wid 贵平台在挖米啦标识 网站主后台站点查看中查询 是 90 tid 挖米啦任务ID 以查询到信息为准且不可修改 是 8b40c45049922938a6c4049fdf72d324 type 跳转类型 是 register 注册跳转 login 登录跳转 wtid 贵平台任务标识 该任务在贵平台任务的标识(同一个任务的wtid在上线后不可更换) 是 100001 sign 签名内容 (32位大写字母) 格式：md5(key+wid+tid) Key 是贵方在我方中网站的安全码 是 6DB96DD0B8EE0D6CCACDB8CE49E750FE 加密方式： 为确保数据调用是安全可靠的，我们采用指纹加密。 合作客户提供密钥key，然后把key和接收到的key,wid,tid连接起来后再进行md5加密，如果产生的sign为小写，则需转换为大写。 如：PHP版本 $sign = md5(key+wid+tid)。 跳转测试环境URL： /jumpTest 附带相关参数可以返回具体信息。 广告类任务 业务流程 用户通过【任务跳转URL】跳转到广告页面注册体验。 有需要提交体验数据的任务（是否需要提交请到网站主后台广告维护中查看），将用户信息通过【广告类任务体验数据提交】提交到挖米啦，提交结果以挖米啦返回信息为准，若挖米啦返回失败，需要用户再次提交。 数据审核成功后挖米啦通过【广告类任务完成通知接口】将任务完成信息推送到贵平台（挖米啦以贵平台返回信息为准，若接失败我们将在下次推送时继续推送直致成功）。 数据审核失败后挖米啦通过【广告类任务失败通知接口】将任务失败信息推送到贵平台（若未推送，请以适当周期自动审核失败）。 4.1广告类任务体验数据提交接口 广告类任务体验数据提交URL，通过此URL将需要提交信息任务的体验信息提交到挖米啦。 URL通过网站主后台【广告维护】功能中查询到需要提交信息任务的数据提交URL。 如果查询页面中没有”信息提交文字“则表示该条广告不需要提交信息。 URL示例： /experInfoSb?wid=3tid=8b40c45049922938a6c4049fdf72d324userid=123456infop=sign=fddf12fdf5be3bedc5065ebea560e45c 接收方式 参数可以通过GET或POST方式接收 参数说明： 请求参数 说明 必填 示例值 userid 贵平台用户ID 替换贵网站登录用户ID 是 123456 tid 挖米啦任务ID 以查询到信息为准且不可修改 是 8b40c45049922938a6c4049fdf72d324 info 提交的信息 替换用户提交的信息 是 wid 贵平台在挖米啦标识 网站主后台站点查看中查询 是 90 ip 用户提交信息时IP地址 是 sign 签名内容 签名内容 (32位大写字母)