美团分销API使用须知
美团分销设置蚂蚁星球推出开放API的目的在于,让具有开发能力的个人京东客,开发团队以及软件开发商更便捷的采集蚂蚁星球商品库的数据,实现优质好单的资源共享。使用蚂蚁星球开放API需要先申请apikey,您可以蚂蚁星球推广中心->开发管理->插件接入查看apikey,单个蚂蚁星球账号只能申请一个apikey。蚂蚁星球开放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表示请求成功 }
接口地址:
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表示请求成功 }