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