平台活动以及插件订单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页面生成秘钥后获取

联系技术支持:712218340 点击链接加入群聊【官方API交流群】(验证语:蚂蚁星球开放平台)

  • 活动列表
  • 活动转链
  • 饿了么转链
  • 充值订单查询
  • 电影票订单查询
  • 点餐订单查询
  • 点餐订单详情
  • 周边优惠订单查询
  • 自营商品订单查询
  • 其他订单查询
    • 详情
    • 错误参照代码
    • 接口地址: 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表示请求成功 
      }
    • status_code=200 成功,其他失败,具体信息见message返回值
    • 详情
    • 错误参照代码
    • 接口地址: 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表示请求成功 
      }
      										
    • status_code=200 成功,其他失败,具体信息见message返回值
    • 详情
    • 错误参照代码
    • 接口地址: 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表示请求成功 
      }
      										
    • status_code=200 成功,其他失败,具体信息见message返回值