美團分銷API使用須知
美團分銷設置螞蟻星球推出開放API的目的在于，讓具有開發(fā)能力的個人京東客，開發(fā)團隊以及軟件開發(fā)商更便捷的采集螞蟻星球商品庫的數據，實現優(yōu)質好單的資源共享。使用螞蟻星球開放API需要先申請apikey，您可以螞蟻星球推廣中心->開發(fā)管理->插件接入查看apikey，單個螞蟻星球賬號只能申請一個apikey。螞蟻星球開放API是免費使用的，但螞蟻星球保留對各接口進行調整的權利，我們會在調整時及時給予通知，也請您持續(xù)關注我們的公告。
接口地址：
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 | 是 | 美團分銷一級渠道號 開發(fā)者中心設置默認后可不傳 |
| promotionId | String | 是 | 美團分銷推廣位ID (在分銷聯盟后臺創(chuàng)建生成) 開發(fā)者中心設置默認后可不傳 |
| activity | String | 是 | 自定義渠道統(tǒng)計參數，最長不超過128字節(jié)，無需在聯盟系統(tǒng)中創(chuàng)建即可使用。 |
| 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.外賣新人首單紅包限新用戶（設備、手機號、美團賬號均未在美團外賣下過單）首次下單使用，且不與其他優(yōu)惠（首減、滿減、滿贈、套餐增、折扣菜）同享；\n6.使用紅包時下單手機號碼必須與收餐人手機號碼、領取紅包時輸入的手機號碼一致；\n7.此活動為部分區(qū)域有效，具體紅包使用有效期及紅包金額以實際收到為準；\n8.其余問題詳見美團外賣客戶端：我的—紅包—美團紅包、商家代金券使用說明；\n9.活動過程中，任何活動參與方存在虛假交易、惡意套利、作弊等不誠信行為，美團外賣有權取消活動參與方的活動資格，并保留依法追究法律責任的權利；\n10.活動期間，如出現不可抗力或情勢變更的情況，美團外賣可依相關法律法規(guī)的規(guī)定主張免責；\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狀態(tài)碼 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 訂單查詢時間區(qū)間類型 1 按照子訂單支付時間查詢，2 按照子訂單核驗時間查詢（注: 等同于startVerifyDate和endVerifyDate查詢，切勿混用）3 按照子訂單結算時間查詢4 按照子訂單賬期時間查詢 |
| startTime | String | 否 | 訂單查詢開始時間（注: 配置queryType使用才會生效） |
| endTime | String | 否 | 訂單查詢結束時間（注: 配置queryType使用才會生效） |
| utmSource | String | 是 | 美團分銷一級渠道號 開發(fā)者中心設置默認后可不傳 |
| promotionId | String | 是 | 美團分銷推廣位ID (在分銷聯盟后臺創(chuàng)建生成) 開發(fā)者中心設置默認后可不傳 |
| 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狀態(tài)碼 200表示請求成功
}
