美團外賣開放平臺對接經驗總結(一)

NO IMAGE

美團外賣開放平臺對接經驗總結(一)

2017-06-21 司想君 司想君

兩個月的時間,在除官方文件之外的資源極其匱乏的條件下,專案組群策群力完成了美團和餓了麼的外賣開放平臺對接,在這裡對團隊成員表示感謝,也把專案中填過的坑,淌過的河分享給大家。這注定是一篇受眾極少的文章,但是希望能夠對需要的人有所幫助。

如果能回到兩個月前,我會告訴剛剛開始開發這個專案的團隊,開發之前,認真看文件。在後續的開發過程中,60%的坑是因為我們沒有認真研究官方文件而產生的。

要相信,由程式設計師屬性的人產出的文件,能寫出來的,都是乾貨。

今天作為開頭第一篇,先整理一些開發人員關注較多的問題進行回答,後續會慢慢深入進去。

首先簡單介紹一下我們的專案,方便大家尋找技術上的共通點(其實是為了打廣告)。

我們的專案全稱是海信外賣聚合平臺。

專案的重點在聚合。對接多家外賣平臺不是我們的目的,對接的再多,也不過是API的搬運工而已。我們要做的,是消化各平臺之間的差異,真正幫商戶實現“一套配置,多平臺可用”的目的。

市場上有很多競品,有的不提供門店管理,有的不提供菜品管理,為什麼呢?因為各平臺的實現差異太大,消化不了,乾脆不做了。

這些不能閉環的系統,都是耍流氓。讓商戶用你的部分功能,還得去操作美團餓了麼百度,不光實現不了三合一,反而成了三變四。還收人家的錢,不是耍流氓是啥。

當然,要做聚合,首先也要先對接。我們第一個面對的問題就是,先對接美團還是先對接餓了麼(百度資質要求太高,我們不達標,目測拿到開發者資質的都是認識他們領導的)。下面從介面豐富程度,易讀性和支援度三方面進行一下小小的對比。

豐富程度

各有千秋。舉個例子:餓了麼對退款狀態的維護極其精細,而美團顆粒較粗;美團配送相關的介面十分豐富,餓了麼卻少之又少。

易讀性

美團完勝。訂單、退款、配送, 美團都有詳細的流程圖,哪個節點應該呼叫哪個介面,標的一清二楚,而餓了麼,一個看似高大上的動態流程圖顯得十分NB,然而並沒有什麼卵用。

支援度

美團完勝。官方討論組,上線支援群。客戶人員很熱心。餓了麼,呵呵,我開發完了以後也不確定他們是不是有人工支援。


綜上所述,如果你對外賣的業務不太熟悉,建議先對接美團。

接下來就先回答幾個美團對接的問題。

  • 回撥地址這麼多,是不是每個都要配置。

       是。如果你覺得哪個不需要,只能說明你對外賣的業務還沒有了解透徹。我們也是開發到一個地方,仔細研究過才發現,奧,原來這個地方確實需要一個回撥。

  • 測試帳號如何下單。

       測試門店為一個座標位於南極洲、配送範圍為西藏昌都的線上測試門店,開發者可使用美團外賣APP定位到西藏昌都氣象局,根據測試門店名稱搜尋到測試門店進行下單。注意加粗字型就好。

  • 如何測試線上支付。

    聯絡運營同學幫你開通。

  • 門店對映,請牢記AuthToken,否則5個門店都用完了只能聯絡客戶解綁。

  • 測試美團專送需要提前申請。

  • 先上傳菜品圖片,再上傳菜品。這個順序不能顛倒。

  • 更新菜品資訊要注意:isSoldOut欄位設為0,否則菜品為下架狀態,官方文件此處有誤,請注意。

  • 上傳菜品圖片介面,文件描述與實際使用有出入,實測並不支援檔案流。

  • 自配送即時單需要手動呼叫配送介面,美團專送即時單和預訂單自動呼叫騎手;美團專送預訂單可以提前手動呼叫配送介面。

    以上是我們在美團對接中曾經遇到的問題,如果有我沒有回答到的,歡迎回復公眾號資訊反饋給我。下一篇,介紹餓了麼對接流程中遇到的問題。歡迎關注,歡迎轉發,更歡迎用以下方式進行打賞,鞭笞作者!