使用蚂蚁星球开放API需要先申请apikey,您可以蚂蚁星球推广中心->开发管理->apikey,单个蚂蚁星球账号只能申请一个apikey。蚂蚁星球开放API是免费使用的,但蚂蚁星球保留对各接口进行调整的权利,我们会在调整时及时给予通知,也请您持续关注我们的公告。
签名算法:md5
签名生成的通用步骤如下
1:将非空参数值的参数按照参数名ASCII码从升序排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串strparam。
特别注意:
◆ 参数名ASCII码从升序排序(字典序);
◆ 接口文档给出参数外的不参与签名;
◆ 如果参数值为空不参与签名;
◆ 参数名区分大小写;
2:在strparam前后拼接上secret=myxqsecret得到strsign字符串,并对strsign进行md5运算,再将得到的字符串所有字符转换为小写,得到sign
请求参数:
apikey=myxqapikey&uid=13915969891&goods_id=1&rechargeno=13915969891&test=1
其中apikey不参与签名,test为无效参数,不参与签名
签名值:
secret=myxqsecret&goods_id=1&rechargeno=13915969891&uid=13915969891&secret=myxqsecret
签名结果:
f8677d7b3c86038436855b8484413c22
注:myxqsecret在蚂蚁星球推广中心->开发管理->apikey页面生成秘钥后获取
接口地址: http://api-gw.haojingke.com/index.php/v2/api/index/actlist
支持格式: json
请求方式: get/post
请求示例: http://api-gw.haojingke.com/index.php/v2/api/index/actlist?apikey=您的apikey&page=1&limit=20
请求参数说明:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
apikey | String | 是 | 蚂蚁星球apikey,请将示例中的key替换成您的key |
page | Integer | 否 | 第几页(默认第1页) |
limit | Integer | 否 | 10-100 默认20 |
actid | Integer | 否 | 活动id |
cid | Integer | 否 | 活动分类id |
kw | String | 否 | 关键词,活动名称检索 |
JSON返回示例:
{ "data": { "hasMore": 0,是否存在下一页 0否1是 "list": [活动列表 { "actid": 14,活动id "act_cid": "3",所属分类 "act_wxappid": "",微信小程序id "act_name": "折扣充值",活动名称 "act_desc": "话费、电费充值92.5折起活动",活动备注 "act_logo": "http://img.haojingke.com/bf6f6b422454be82dcdf8421b7025d3a0177bbf4a1be0e9exnCdrhppLy.png",活动logo "act_banner": "http://img.haojingke.com/b5f286371426edd726ba9f4b83debd70eee693281097103cSrPPIFczk0.jpg",活动banner "act_bg": "http://img.haojingke.com/42d0a6f15f10401180af5ee24474b558200201565f09190aBmjTUQgKng.jpg",活动背景 "act_rate": "1%-5%",佣金比例 "begintime": 1640966400,活动开始时间 "endtime": 1703952000,活动结束时间 "balance_date": "每周二",结算日期 "act_wenan": "话费、电费充值92.5折起活动\r\n链接:[下单链接]",活动文案 "act_note": "1.不支持持电卡非智能电表电费缴费业务。",活动说明 "balance_cycle": "周结"结算周期 } ], "total": 46,总数 "cat": [ { "cid": 3,分类id "cname": "生活缴费",分类名称 }, { "cid": 1, "cname": "餐饮外卖", }, { "cid": 2, "cname": "交通出行", } ] }, "message": "success",提示信息 "status_code": 200状态码 200表示请求成功 }
接口地址: http://api-gw.haojingke.com/index.php/v2/api/index/actunionurl
支持格式: json
请求方式: get/post
请求示例: http://api-gw.haojingke.com/index.php/v2/api/index/actunionurl?apikey=您的apikey&actid=1&extend_id=
请求参数说明:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
apikey | String | 是 | 蚂蚁星球apikey,请将示例中的key替换成您的key |
actid | Integer | 是 | 活动id |
extend_id | String | 是 | 渠道标识(自定义推广位) |
JSON返回示例:
{ "data": { "url": "https://u.ele.me/Iw8v78xD",链接 "shorturl": "https://u.ele.me/Iw8v78xD",短链 "poster": "https://img.alicdn.com/imgextra/i3/6000000005368/O1CN016r2a0E1pWathe5WcY_!!6000000005368-0-o2oad.jpg",推广海报 "we_app_info": {小程序信息 "app_id": "wxece3a9a4c82f58c9",小程序appid "path": "commercialize/pages/taoke-guide/index?scene=77411a2335de46ed9bc31e868a7db9b6",小程序路径 "minicode": "https://img.alicdn.com/imgextra/i1/6000000002240/O1CN01upHmnF1SPy0O5tKFr_!!6000000002240-0-o2oad.jpg"小程序码 }, "wenan": "饿了么狂撒红包①亿,打开链接领取【饿了么隐藏】优惠\r\n下单链接:https://u.ele.me/Iw8v78xD"文案 }, "message": "success",提示信息 "status_code": 200状态码 200表示请求成功 }
接口地址:
http://api-gw.haojingke.com/index.php/v2/api/index/elemeunionurl
官方文档
支持格式: json
请求方式: get/post
请求示例: http://api-gw.haojingke.com/index.php/v2/api/index/elemeunionurl?apikey=您的apikey&activity_id=1&extend_id=
请求参数说明:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
apikey | String | 是 | 蚂蚁星球apikey,请将示例中的key替换成您的key |
activity_id | Integer | 是 | 活动id 饿了么零售会场 10247,饿了么天天领红包 10144,饿了么浏览店铺做任务 10174 |
extend_id | String | 是 | 渠道标识(自定义推广位) |
JSON返回示例:
{ "data": { "url": "https://u.ele.me/Iw8v78xD",链接 "shorturl": "https://u.ele.me/Iw8v78xD",短链 "poster": "https://img.alicdn.com/imgextra/i3/6000000005368/O1CN016r2a0E1pWathe5WcY_!!6000000005368-0-o2oad.jpg",推广海报 "we_app_info": {小程序信息 "app_id": "wxece3a9a4c82f58c9",小程序appid "path": "commercialize/pages/taoke-guide/index?scene=77411a2335de46ed9bc31e868a7db9b6",小程序路径 "minicode": "https://img.alicdn.com/imgextra/i1/6000000002240/O1CN01upHmnF1SPy0O5tKFr_!!6000000002240-0-o2oad.jpg"小程序码 }, "wenan": "饿了么狂撒红包①亿,打开链接领取【饿了么隐藏】优惠\r\n下单链接:https://u.ele.me/Iw8v78xD"文案 }, "message": "success",提示信息 "status_code": 200状态码 200表示请求成功 }