【平臺介紹】
美麗說是國內最大的女性快時尚電子商務平臺,致力于為年輕時尚愛美的女性用戶提供最流行的時尚購物體驗,擁有超過1億的女性注冊用戶,用戶年齡集中在18歲到35歲。2013年11月,美麗說開始建立電子商務交易平臺,精選上千家優(yōu)質賣家供應商,為用戶提供女裝、女鞋、女包、配飾、美妝等品類的優(yōu)質時尚商品,成功轉型為女性時尚垂直品類電商。
【授權說明】
蘑菇街平臺是授權型平臺。
app_key:商家ID
secret:秘鑰
access_token:授權碼
【獲取方式】
開發(fā)者創(chuàng)建的應用標識,創(chuàng)建應用后在 控制臺》應用列表 可以看到。標識應用身份,在控制臺應用列表里可以得到,獲取Code、請求加簽時必要參數。用戶授權授權給應用換取AccessToken與RefreshToken的key,獲取AccessToken必要參數,有效期為5分鐘,或換取AccessToken后失效。應用通過Code換取到最終頒發(fā)給應用的令牌,調用API必要參數,有效期為7天,同一個用戶對應一個AppKey只會生效最后一次授權的AccessToken與RefreshToken。
創(chuàng)建應用獲取app_key和secret:美麗說開放平臺接口文檔
美麗說開放平臺為成為開發(fā)者的第三方接入用戶提供對接入口,相關的API包括店鋪、商品、交易、聯盟等,對接開放平臺流程如下:
1)美麗說開放平臺要求第三方接入用戶首先注冊成為美麗說的用戶,并通過主站的賬號注冊成為開放平臺開發(fā)者。
若您尚未注冊美麗說,請先前往主站注冊成為美麗說用戶。
2)在開放平臺點擊【登錄】進入主站登錄頁面,若未注冊,請先在主站注冊,公司、企業(yè)請使用法人信息注冊,以免人員變換導致不變。
2.登錄成功后,點擊右上角用戶昵稱下拉菜單的【用戶中心】,或者導航欄中的【控制臺】,進入開發(fā)者注冊頁面。
3.如果當前登錄賬號未認證,會進入認證流程,個人、個體用戶請申請個人認證,公司、企業(yè)請申請企業(yè)認證,只有認證通過后才能繼續(xù)操作。
4.認證通過后點"已認證,下一步"按鈕進入開發(fā)者注冊頁面錄入基本信息后,點擊【提交】,即完成了開發(fā)者注冊。當前僅支持企業(yè)開發(fā)者,請一定要按照要求提供必要的資質證書。
申請成為開發(fā)者后,需要進行開發(fā)者審核,一般會在5-10個工作日內完成審核。請注意查收郵件與短信。
如果申請的資料不全,開發(fā)平臺會審核不通過,并標明審核不通過的原因,請申請客戶根據反饋信息,重新修改注冊信息,再次提交審核。
注冊成為開發(fā)者以后便可在【控制臺》應用列表】頁面進行創(chuàng)建應用。首先填寫應用的基本信息,填寫完畢點下一步選擇需要申請的Api列表,可以通過Api分組申請權限。
提交申請后,開放平臺會根據客戶提交的信息審核用戶訪問Api的請求。審核通過后,用戶可以對應用進行測試開發(fā)。
開放平臺提供API的測試工具,供開發(fā)者測試。首頁發(fā)布流程中點擊“Api”,進入API詳情頁面,點擊【Api測試工具】進入:
進入測試頁面后,左側分別錄入系統級輸入參數、應用級輸入參數后,點擊【提交測試】,即可在右側查看當前API的調用結果:
1.上線/下線
應用開發(fā)完畢后對其上線操作后可以獲取正常流量,否則會被限制再1qps/s,新應用默認線下狀態(tài);應用下線后將不再提供服務。
2.API
應用API權限申請入口,申請權限后需要等待審批,審批通過后才可調用,否則會返回 "API未訂閱或者審批未通過"(0000009) 錯誤。
3.監(jiān)控
應用調用蘑菇街開放平臺API監(jiān)控,開發(fā)者可以在此了解自己應用的API調用情況,以及時調整應用。
4.測試
測試應用API調用,也可作為故障排查的工具,注意此處授權也會更新用戶對該應用的AccessToken。
此流程要求ISV或商家(自主研發(fā)應用)有web服務器,能夠保持應用本身的密鑰以及狀態(tài),可以通過http直接訪問美麗說的授權服務器。
1.通過用戶授權獲取授權碼Code(獲取授權碼鏈接)
通過拼接以下鏈接打開用戶登錄頁面:https://oauth.meilishuo.com/authorize?response_type=code&app_key=YOUR_APPKEY&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&state=YOUR_CUSTOM_CODE
求方法:GET
請求參數:
參數 | 是否必選 | 參數說明 |
---|---|---|
返回說明:
如果用戶成功登錄并授權,則會跳轉到指定的回調地址,并在redirect_uri地址后帶上Authorization Code和原始的state值。
2.用上一步獲取的Authorization Code,和AppSecret 通過Http POST方式換取Token。(獲取訪問令牌)
通過拼接以下鏈接(注意替換以下app_key、redirect_uri和state)打開用戶登錄頁面:https://oauth.meilishuo.com/token?code=YOUR_AUTHCODE&grant_type=authorization_code&app_key=YOUR_APPKEY&app_secret=YOUR_APPSECRET&redirect_uri=YOUR_REGISTERED_REDIRECT_URI
請求方法:GET
請求參數:
參數 | 是否必選 | 參數說明 |
---|---|---|
返回說明:(如果成功返回,即可獲取如下參數)
參數 | 描述 |
---|---|
此流程適合ISV沒有自己的web服務器,且應用為原生程序,即客戶端應用(同時應用無法與瀏覽器交互,但是可以外調用瀏覽器)。
請求的流程:(1)用戶發(fā)起授權請求, 開放平臺驗證后獲取code并置換出AccessToken 》 (2)獲取url中的AccessToken 》 (3