美团分销API

美团分销API使用须知

美团分销设置

蚂蚁星球推出开放API的目的在于，让具有开发能力的个人京东客，开发团队以及软件开发商更便捷的采集蚂蚁星球商品库的数据，实现优质好单的资源共享。使用蚂蚁星球开放API需要先申请apikey，您可以在本页面上方点击申请按钮或直接进入个人中心开放API页面申请，单个蚂蚁星球账号只能申请一个apikey。蚂蚁星球开放API是免费使用的，但蚂蚁星球保留对各接口进行调整的权利，我们会在调整时及时给予通知，也请您持续关注我们的公告。

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

详情
错误参照代码

接口地址： http://api-gw.haojingke.com/index.php/v1/api/mt/getunionurl

官方文档

支持格式： json

请求方式： get/post

请求示例： http://api-gw.haojingke.com/index.php/v1/api/mt/getunionurl?apikey=您的apikey&goods_id=2165850533&chanTag=1000100

请求参数说明：

名称	类型	必填	说明
apikey	String	是	蚂蚁星球apikey，请将示例中的key替换成您的key
utmSource	String	是	美团分销一级渠道号开发者中心设置默认后可不传
promotionId	String	是	美团分销推广位ID (在分销联盟后台创建生成) 开发者中心设置默认后可不传
activity	String	是	自定义渠道统计参数，最长不超过128字节，无需在联盟系统中创建即可使用。
positionid	Int	是	自定义推广位id，整型数字

JSON返回示例：

                                                {
    "data": {
        "data": {
            "activity": "OwMkGzn6oK",
            "commonLink": "https://click.meituan.com/t?t=1&c=1&p=OWMpZ-uzIFOVe6JyOONs3VzolOCHG2b7aH-XB09jFlbbAeBCxOxg6qjsKAN88woE4LkL1DjQG3mYC47BzKEhw4kO8nM4448wtmhc-zoYIoUcBpMPMTXkDagJFgew_qmu1IBCTd9p5uuCEfQeiPhJJ4qWxxdWJjfPP6SAyjS3-7R4bOBWhi_ZOinRckaz5OqxdyOesoYx1c77vnV8PFkeibvWdOGbxJzhtY90_18QHzKtsuBC8OLp6uxl8ITM0lBJtcfWg4W6x6iMdMNwWsws3IbYmtvCQ5V2wLs7hp7HMSab586Ys0uadq5YONc1ZGmQqH84fL808varOx6otZftRngwajW17qtvin1PQfjHHY0ZajeyBbhyyHVrYUJhmQcwIhB-dZxjZobvmqsxrR8c4KwfWyThxBZJvVaL8Q3M-LD6FsNy8BdLhSD7hYnwPNb2uGfhTsnZIMoPTM19D9z2mdo6es9ptRJtE9j2fLPO_lv06g5aIGcq-3zenFS-Wjwpk3dPeXz32n6iMn00vmeUrQ",
            "shortLink": "http://dpurl.cn/QawY6Gxz",
            "commonQrCode": "",
            "miniProgramPath": "/index/pages/h5/h5?f_userId=1&f_token=1&s_cps=1&weburl=https%3A%2F%2Fdpurl.cn%2FQawY6Gxz",
            "miniProgramQrCode": "",
            "materialDownloadLink": "https://mss-shon.sankuai.com/cps-bucket/%E8%81%94%E7%9B%9F%E5%88%86%E4%BA%AB%E5%9B%BE%E6%96%87%E6%A1%88%E9%85%8D%E7%BD%AE.zip?AWSAccessKeyId=9f36d233a9434e10bc3e2dde9f327f02&Expires=1621842280&Signature=y8MRUSrTnaxlGbSYFrns%2BROjXgs%3D",
            "beginTime": 1601540091,
            "endTime": 1640938491,
            "ruleInfo": "1.本次活动中红包领取时间截止至2021年12月31日24点；\n2.订单同步为次日，例如12日下的订单，在13日24：00前可同步到返佣订单；\n3.红包可在美团或美团外卖最新版客户端、美团外卖小程序下单且选择在线支付时使用； \n4.红包仅限非到店自取外卖订单，下午茶、夜宵、美食、蛋糕、团餐频道、甜点饮品频道使用；\n5.外卖新人首单红包限新用户（设备、手机号、美团账号均未在美团外卖下过单）首次下单使用，且不与其他优惠（首减、满减、满赠、套餐增、折扣菜）同享；\n6.使用红包时下单手机号码必须与收餐人手机号码、领取红包时输入的手机号码一致；\n7.此活动为部分区域有效，具体红包使用有效期及红包金额以实际收到为准；\n8.其余问题详见美团外卖客户端：我的—红包—美团红包、商家代金券使用说明；\n9.活动过程中，任何活动参与方存在虚假交易、恶意套利、作弊等不诚信行为，美团外卖有权取消活动参与方的活动资格，并保留依法追究法律责任的权利；\n10.活动期间，如出现不可抗力或情势变更的情况，美团外卖可依相关法律法规的规定主张免责；\n11.如有其它疑问请咨询美团外卖客服10109777。"
        },
        "unionurl": "http://dpurl.cn/QawY6Gxz",
        "appid": "wxde8ac0a21135c07d",
        "ghid": "gh_870576f3c6f9",
        "path": "/index/pages/h5/h5?f_userId=1&f_token=1&s_cps=1&weburl=https%3A%2F%2Fdpurl.cn%2FQawY6Gxz"
    },
    "message": "success",提示信息 
    "status_code": 200状态码 200表示请求成功 
}

status_code=200 成功，其他失败，具体信息见message返回值

详情
错误参照代码

接口地址： http://api-gw.haojingke.com/index.php/v1/api/mt/getorder?apikey=您的apikey

官方文档

支持格式： json

请求方式： get/post

请求示例： http://api-gw.haojingke.com/index.php/v1/api/mt/getorder?apikey=您的apikey

请求参数说明：

名称	类型	必填	说明
apikey	String	是	蚂蚁星球apikey，请将示例中的key替换成您的key
page	Integer	否	第几页（默认第1页）
size	Integer	否	10-100 默认20
queryType	Integer	否	默认1 订单查询时间区间类型 1 按照子订单支付时间查询，2 按照子订单核验时间查询（注: 等同于startVerifyDate和endVerifyDate查询，切勿混用）3 按照子订单结算时间查询4 按照子订单账期时间查询
startTime	String	否	订单查询开始时间（注: 配置queryType使用才会生效）
endTime	String	否	订单查询结束时间（注: 配置queryType使用才会生效）
utmSource	String	是	美团分销一级渠道号开发者中心设置默认后可不传
promotionId	String	是	美团分销推广位ID (在分销联盟后台创建生成) 开发者中心设置默认后可不传
startVerifyDate	String	否	订单核验起始日期，支持日期与时间格式。日期：2019-05-08 时间：2019-05-08 00:00:00
endVerifyDate	String	否	订单核验结束日期，支持日期与时间格式。日期：2019-05-08 时间：2019-05-08 23:59:59

                                                {
  "data": {
    "code": 200,
    "msg": {
      "recordCount": 3,
      "page": 1,
      "pageSize": 20,
      "records": [
        {
          "verifyDate": "2021-04-21",
          "verifyTime": "2021-04-21 12:43:01",
          "itemId": 1396679802395734000,
          "uniqueItemId": 1396679802395734000,
          "orderPayTime": "2021-04-21 12:09:44",
          "orderId": "77540360970748595",
          "actualItemAmount": "17.3",
          "actualOrderAmount": "17.3",
          "shopId": 7754036,
          "shopUuid": "7754036",
          "shopName": "七克轻食沙拉（金湖帝景店）",
          "brandName": "",
          "cityName": "未知",
          "cat0Name": "未知",
          "cat1Name": "未知",
          "orderType": "外卖",
          "couponId": "ktsBvvavaPPyAsP&source=tsid=wKtssPwKO",
          "couponGroupId": 0,
          "couponDiscountAmount": "4",
          "couponPriceLimit": "20",
          "balanceAmount": "1.04",
          "balanceCommissionRatio": "0.06",
          "orderUserId": "16*****03",
          "itemStatus": 1,
          "balanceStatus": 1,
          "settlementType": "未知",
          "couponSource": "cube",
          "orderPlatform": "美团",
          "utmSource": 112233,
          "utmMedium": "30fe00d4f1173fb4a1c1dc60a4849f4a",
          "modifyTime": "2021-05-24 12:43:12",
          "addDate": "2021-05-24",
          "itemBizStatus": 2,
          "billingDate": "2021-05-24 00:00:00",
          "promotionId": "11111",
          "dealId": 0,
          "positionid": "1056410"
        }
      ]
    },
    "serverTrackId": "8540251870606909101"
  },
    "message": "success",提示信息 
    "status_code": 200状态码 200表示请求成功 
}

status_code=200 成功，其他失败，具体信息见message返回值