插件接入API使用须知
插件接入设置使用蚂蚁星球开放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表示请求成功
}
