閑魚(yú)開(kāi)放平臺(tái)

閑魚(yú)開(kāi)放平臺(tái)

專用API
【更新時(shí)間: 2024.08.15】 閑魚(yú)開(kāi)放平臺(tái)是阿里巴巴集團(tuán)旗下閑魚(yú)項(xiàng)目的開(kāi)放接口平臺(tái)，專為開(kāi)發(fā)者提供技術(shù)支持和服務(wù)。通過(guò)開(kāi)放的閑魚(yú)API，幫助開(kāi)發(fā)者快速集成閑魚(yú)的多種功能。無(wú)論是商品發(fā)布、訂單管理還是用戶互動(dòng)，閑魚(yú)API都能為開(kāi)發(fā)者提供便捷的解決方案。
瀏覽次數(shù)
455
采購(gòu)人數(shù)
14
試用次數(shù)
3
! SLA: N/A
! 響應(yīng): N/A
! 適用于個(gè)人&企業(yè)
試用
收藏
×
完成
取消
×
書(shū)簽名稱
確定
<
產(chǎn)品介紹
>

什么是閑魚(yú)開(kāi)放平臺(tái)?

該服務(wù)是為閑魚(yú)小程序合作方提供的服務(wù)端接入文檔，詳細(xì)說(shuō)明了如何在聚石塔環(huán)境中部署服務(wù)端服務(wù)，如何進(jìn)行用戶登錄授權(quán)，以及如何使用閑魚(yú)提供的API進(jìn)行訂單管理和用戶信息查詢等操作。文檔提供了詳細(xì)的API列表、消息匯總、API調(diào)用身份說(shuō)明、TOPAPI環(huán)境地址確認(rèn)、權(quán)限申請(qǐng)流程以及部分API的詳細(xì)說(shuō)明，旨在幫助合作方快速接入閑魚(yú)平臺(tái)，實(shí)現(xiàn)業(yè)務(wù)的自動(dòng)化和智能化管理。

閑魚(yú)開(kāi)放平臺(tái)有哪些核心功能？

  1. 訂單創(chuàng)建：服務(wù)商可以通過(guò)TOP接口調(diào)用創(chuàng)單API創(chuàng)建閑魚(yú)訂單
  2. 發(fā)貨接口-虛擬發(fā)貨：該接口適用于無(wú)需物流發(fā)貨的場(chǎng)景。對(duì)應(yīng)創(chuàng)單時(shí)不需要傳入deliver_id的情況。
  3. 發(fā)貨接口-有物流發(fā)貨：有實(shí)物物流的發(fā)貨場(chǎng)景，對(duì)應(yīng)創(chuàng)單時(shí)需要傳入deliver_id的情況
  4. 物流公司編碼查詢：通過(guò)該接口可以查詢支持的物流公司編碼。
  5. 逆向訂單查詢：該接口用于查詢用戶退貨、換貨等逆向訂單信息。
  6. 正向訂單查詢：該接口用于查詢用戶購(gòu)買(mǎi)的正向訂單信息。
  7. 退款單處理：通過(guò)該接口可以處理用戶的退款申請(qǐng)。
  8. 服務(wù)商主動(dòng)取消訂單（未發(fā)貨）：服務(wù)商在訂單未發(fā)貨的情況下，可以通過(guò)該接口主動(dòng)取消訂單。
  9. 正向訂單變更消息：該接口用于查詢或監(jiān)聽(tīng)正向訂單的變更消息。
  10. 逆向訂單變更消息：該接口用于查詢或監(jiān)聽(tīng)逆向訂單的變更消息。
  11. 用戶基礎(chǔ)信息（性別、頭像、昵稱）：該接口用于獲取用戶的基礎(chǔ)信息，包括性別、頭像和昵稱。

閑魚(yú)開(kāi)放平臺(tái)的核心優(yōu)勢(shì)是什么？

 

  1. 豐富的功能接口：閑魚(yú)開(kāi)放平臺(tái)提供了多種接口，覆蓋商品管理、訂單處理、用戶管理等各個(gè)方面，滿足開(kāi)發(fā)者的多樣化需求。
  2. 高效的開(kāi)發(fā)支持：平臺(tái)提供詳細(xì)的開(kāi)發(fā)文檔和技術(shù)支持，幫助開(kāi)發(fā)者快速上手并高效完成開(kāi)發(fā)任務(wù)。
  3. 穩(wěn)定的系統(tǒng)性能：作為阿里巴巴旗下產(chǎn)品，閑魚(yú)開(kāi)放平臺(tái)擁有強(qiáng)大的技術(shù)底蘊(yùn)和穩(wěn)定的系統(tǒng)性能，確保開(kāi)發(fā)者在使用過(guò)程中能夠獲得良好的體驗(yàn)。

 

在哪些場(chǎng)景會(huì)用到閑魚(yú)開(kāi)放平臺(tái)？

電商平臺(tái)的二手商品專區(qū)：一個(gè)大型電商平臺(tái)想要增加一個(gè)二手商品交易專區(qū)，可以通過(guò)閑魚(yú)開(kāi)放平臺(tái)的接口，將商品發(fā)布、訂單管理等功能接入到自己的平臺(tái)中，從而為用戶提供一個(gè)可靠的二手商品交易服務(wù)。

 

 
社交媒體的二手交易功能：一個(gè)社交媒體平臺(tái)希望增加用戶互動(dòng)的多樣性，決定增加二手交易功能。通過(guò)閑魚(yú)開(kāi)放平臺(tái)的用戶管理和商品發(fā)布接口，可以讓用戶在社交平臺(tái)上直接發(fā)布和管理自己的二手商品，增強(qiáng)平臺(tái)的用戶粘性。

 
二手商品市場(chǎng)分析：在電商平臺(tái)上，二手商品市場(chǎng)的需求不斷增長(zhǎng)。利用“閑魚(yú)開(kāi)放平臺(tái)”API接口，商家可以實(shí)時(shí)獲取閑魚(yú)上的商品信息，如價(jià)格、銷量和用戶評(píng)論。這些數(shù)據(jù)可以幫助商家分析市場(chǎng)趨勢(shì)、制定定價(jià)策略以及優(yōu)化庫(kù)存管理。

 
<
使用指南
>

服務(wù)API使用指南

1. 環(huán)境準(zhǔn)備

1.1 聚石塔接入

  • 所有服務(wù)端服務(wù)必須部署在聚石塔內(nèi)。

  • 用戶ID、訂單信息需存儲(chǔ)在聚石塔數(shù)據(jù)庫(kù)中。

  • 訪問(wèn)聚石塔外部資源需要審批。

1.2 相關(guān)文檔

2. 用戶登錄授權(quán)

2.1 授權(quán)流程

  1. 前端獲取授權(quán)碼（code）。

  2. 服務(wù)器使用code和AppSecret調(diào)用taobao.top.auth.token.create接口換取accessToken。

  3. accessToken用于后續(xù)請(qǐng)求TOP接口。

2.2 注意事項(xiàng)

  • 授權(quán)碼僅能使用一次，需重新獲取。

  • accessToken在過(guò)期之前無(wú)需重新獲取。

  • 可使用setStorage和getStorage API緩存用戶信息，避免頻繁獲取code。

3. API調(diào)用

3.1 API匯總

  • 訂單創(chuàng)建: alibaba.idle.isv.goosefish.order.create

  • 訂單查詢（正向）: alibaba.idle.isv.order.query

  • 虛擬發(fā)貨: alibaba.idle.isv.goosefish.virtual.delivery

  • 物流發(fā)貨: alibaba.idle.isv.order.ship

  • 訂單查詢（逆向）: alibaba.idle.isv.refund.query

  • 發(fā)貨前關(guān)閉訂單: alibaba.idle.isv.order.close

  • 部分退款: alibaba.idle.isv.order.part.refund

  • 發(fā)貨后退款關(guān)單: alibaba.idle.isv.order.after.send.refund

  • 退貨退款處理: alibaba.idle.isv.order.dealrefund

  • 物流公司編碼查詢: alibaba.idle.logistics.companies.query

  • 用戶基礎(chǔ)信息: alibaba.idle.goosefish.user.info.query

3.2 消息匯總

  • 正向交易消息: idle_autotrade_OrderStateSync

  • 逆向交易消息: idle_autotrade_RefundSync

4. API調(diào)用身份說(shuō)明

  • 訂單創(chuàng)建和用戶基礎(chǔ)信息接口需使用當(dāng)前登錄用戶的accessToken。

  • 其他涉及賣(mài)家的接口需使用賣(mài)家的accessToken。

5. TOPAPI 環(huán)境地址

  • 正式地址: https://gw.api.taobao.com/router/rest

  • 預(yù)發(fā)地址: https://pre-gw.api.taobao.com/top/router/rest（僅在閑魚(yú)側(cè)更新或新增時(shí)使用）

5.1 預(yù)發(fā)聯(lián)調(diào)

  • 在聯(lián)調(diào)前聯(lián)系閑魚(yú)開(kāi)發(fā)同學(xué)開(kāi)通預(yù)發(fā)環(huán)境聯(lián)調(diào)權(quán)限。

6. 權(quán)限申請(qǐng)

  • 在閑魚(yú)三方開(kāi)發(fā)平臺(tái)發(fā)起API權(quán)限申請(qǐng)，確保只申請(qǐng)必要的API。

7. 部分API詳細(xì)說(shuō)明

7.1 訂單創(chuàng)建

  • 調(diào)用alibaba.idle.isv.goosefish.order.create創(chuàng)建閑魚(yú)訂單。

7.2 訂單查詢

  • 使用alibaba.idle.isv.order.query查詢訂單狀態(tài)。

7.3 發(fā)貨接口

  • 虛擬發(fā)貨: 使用alibaba.idle.isv.goosefish.virtual.delivery接口。

  • 有物流發(fā)貨: 使用alibaba.idle.isv.order.ship接口。

7.4 逆向訂單查詢

  • 使用alibaba.idle.isv.refund.query查詢退款狀態(tài)。

7.5 退款處理

  • 使用alibaba.idle.isv.order.dealrefund處理退款。

8. 消息處理

  • 監(jiān)聽(tīng)idle_autotrade_OrderStateSync和idle_autotrade_RefundSync消息以獲取訂單狀態(tài)變化。

通過(guò)以上步驟，用戶可以順利對(duì)接和集成服務(wù)API。

 

詳情查看鏈接：https://open.goofish.com/doc/development/dev/server.html

<
產(chǎn)品問(wèn)答
>
?
初次接入小程序，需要申請(qǐng)哪些權(quán)限?
權(quán)限分為客戶端接口權(quán)限和服務(wù)端接口權(quán)限，需要在管理平臺(tái)上申請(qǐng)權(quán)限后才能使用。具體可以參考【小程序快速接入】申請(qǐng)API權(quán)限
?
小程序?qū)g覽器API支持是否完整；在SPA應(yīng)用下，是否支持History模式？
都支持的。閑魚(yú)小程序可以理解為一個(gè)能力增強(qiáng)，但是被平臺(tái)管控受限的H5。都支持的。閑魚(yú)小程序可以理解為一個(gè)能力增強(qiáng)，但是被平臺(tái)管控受限的H5。
?
入駐閑魚(yú)小程序，必須要部署“聚石塔服務(wù)”嗎？
是的。閑魚(yú)小程序調(diào)用的后端接口，都必須部署到聚石塔上。
?
聚石塔如何接入？
參考文檔：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2參考文檔：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2
?
部署到聚石塔的接口可以調(diào)用外部接口嗎？
可以。聚石塔內(nèi)外互通是通過(guò)奇門(mén)接口實(shí)現(xiàn)的。具體可以參考：聚石塔內(nèi)外互通說(shuō)明。
?
小程序內(nèi)使用的閑魚(yú)賬號(hào)和淘寶開(kāi)發(fā)者賬號(hào)，可以用個(gè)人賬號(hào)嗎？如果是用個(gè)人賬號(hào)，后期還能再變更為公司賬戶...
為保障整體業(yè)務(wù)流暢，請(qǐng)使用與閑魚(yú)簽約的企業(yè)賬號(hào)申請(qǐng)閑魚(yú)賬號(hào)和淘寶開(kāi)發(fā)者賬號(hào)；如果使用個(gè)人賬號(hào)，后期不支持變更，所以推薦使用企業(yè)賬號(hào)。理論上淘寶開(kāi)放平臺(tái)入駐主體 、閑魚(yú)入駐主體、合同簽約主體，三者應(yīng)該一致。為保障整體業(yè)務(wù)流暢，請(qǐng)使用與閑魚(yú)簽約的企業(yè)賬號(hào)申請(qǐng)閑魚(yú)賬號(hào)和淘寶開(kāi)發(fā)者賬號(hào)；如果使用個(gè)人賬號(hào)，后期不支持變更，所以推薦使用企業(yè)賬號(hào)。理論上淘寶開(kāi)放平臺(tái)入駐主體 、閑魚(yú)入駐主體、合同簽約主體，三者應(yīng)該一致。
<
關(guān)于我們
>
閑魚(yú)是中國(guó)領(lǐng)先的二手交易平臺(tái)，隸屬于阿里巴巴集團(tuán)，致力于為用戶提供安全、便捷的二手商品交易服務(wù)。用戶可以通過(guò)閑魚(yú)發(fā)布、購(gòu)買(mǎi)和交換二手商品，同時(shí)享受專業(yè)的售后保障和社區(qū)互動(dòng)功能。閑魚(yú)開(kāi)放平臺(tái)提供豐富的API接口，支持小程序開(kāi)發(fā)者快速接入和發(fā)布集成，為廣大開(kāi)發(fā)者提供了便利的技術(shù)支持和文檔指導(dǎo)。
聯(lián)系信息
服務(wù)時(shí)間： 00:00:00至24:00:00
網(wǎng)頁(yè)在線客服： 咨詢
<
最可能同場(chǎng)景使用的其他API
>
API接口列表
<
使用指南
>

服務(wù)API使用指南

1. 環(huán)境準(zhǔn)備

1.1 聚石塔接入

  • 所有服務(wù)端服務(wù)必須部署在聚石塔內(nèi)。

  • 用戶ID、訂單信息需存儲(chǔ)在聚石塔數(shù)據(jù)庫(kù)中。

  • 訪問(wèn)聚石塔外部資源需要審批。

1.2 相關(guān)文檔

2. 用戶登錄授權(quán)

2.1 授權(quán)流程

  1. 前端獲取授權(quán)碼（code）。

  2. 服務(wù)器使用code和AppSecret調(diào)用taobao.top.auth.token.create接口換取accessToken。

  3. accessToken用于后續(xù)請(qǐng)求TOP接口。

2.2 注意事項(xiàng)

  • 授權(quán)碼僅能使用一次，需重新獲取。

  • accessToken在過(guò)期之前無(wú)需重新獲取。

  • 可使用setStorage和getStorage API緩存用戶信息，避免頻繁獲取code。

3. API調(diào)用

3.1 API匯總

  • 訂單創(chuàng)建: alibaba.idle.isv.goosefish.order.create

  • 訂單查詢（正向）: alibaba.idle.isv.order.query

  • 虛擬發(fā)貨: alibaba.idle.isv.goosefish.virtual.delivery

  • 物流發(fā)貨: alibaba.idle.isv.order.ship

  • 訂單查詢（逆向）: alibaba.idle.isv.refund.query

  • 發(fā)貨前關(guān)閉訂單: alibaba.idle.isv.order.close

  • 部分退款: alibaba.idle.isv.order.part.refund

  • 發(fā)貨后退款關(guān)單: alibaba.idle.isv.order.after.send.refund

  • 退貨退款處理: alibaba.idle.isv.order.dealrefund

  • 物流公司編碼查詢: alibaba.idle.logistics.companies.query

  • 用戶基礎(chǔ)信息: alibaba.idle.goosefish.user.info.query

3.2 消息匯總

  • 正向交易消息: idle_autotrade_OrderStateSync

  • 逆向交易消息: idle_autotrade_RefundSync

4. API調(diào)用身份說(shuō)明

  • 訂單創(chuàng)建和用戶基礎(chǔ)信息接口需使用當(dāng)前登錄用戶的accessToken。

  • 其他涉及賣(mài)家的接口需使用賣(mài)家的accessToken。

5. TOPAPI 環(huán)境地址

  • 正式地址: https://gw.api.taobao.com/router/rest

  • 預(yù)發(fā)地址: https://pre-gw.api.taobao.com/top/router/rest（僅在閑魚(yú)側(cè)更新或新增時(shí)使用）

5.1 預(yù)發(fā)聯(lián)調(diào)

  • 在聯(lián)調(diào)前聯(lián)系閑魚(yú)開(kāi)發(fā)同學(xué)開(kāi)通預(yù)發(fā)環(huán)境聯(lián)調(diào)權(quán)限。

6. 權(quán)限申請(qǐng)

  • 在閑魚(yú)三方開(kāi)發(fā)平臺(tái)發(fā)起API權(quán)限申請(qǐng)，確保只申請(qǐng)必要的API。

7. 部分API詳細(xì)說(shuō)明

7.1 訂單創(chuàng)建

  • 調(diào)用alibaba.idle.isv.goosefish.order.create創(chuàng)建閑魚(yú)訂單。

7.2 訂單查詢

  • 使用alibaba.idle.isv.order.query查詢訂單狀態(tài)。

7.3 發(fā)貨接口

  • 虛擬發(fā)貨: 使用alibaba.idle.isv.goosefish.virtual.delivery接口。

  • 有物流發(fā)貨: 使用alibaba.idle.isv.order.ship接口。

7.4 逆向訂單查詢

  • 使用alibaba.idle.isv.refund.query查詢退款狀態(tài)。

7.5 退款處理

  • 使用alibaba.idle.isv.order.dealrefund處理退款。

8. 消息處理

  • 監(jiān)聽(tīng)idle_autotrade_OrderStateSync和idle_autotrade_RefundSync消息以獲取訂單狀態(tài)變化。

通過(guò)以上步驟，用戶可以順利對(duì)接和集成服務(wù)API。

 

詳情查看鏈接：https://open.goofish.com/doc/development/dev/server.html

<
依賴服務(wù)
>
<
產(chǎn)品問(wèn)答
>
?
初次接入小程序，需要申請(qǐng)哪些權(quán)限?
權(quán)限分為客戶端接口權(quán)限和服務(wù)端接口權(quán)限，需要在管理平臺(tái)上申請(qǐng)權(quán)限后才能使用。具體可以參考【小程序快速接入】申請(qǐng)API權(quán)限
?
小程序?qū)g覽器API支持是否完整；在SPA應(yīng)用下，是否支持History模式？
都支持的。閑魚(yú)小程序可以理解為一個(gè)能力增強(qiáng)，但是被平臺(tái)管控受限的H5。都支持的。閑魚(yú)小程序可以理解為一個(gè)能力增強(qiáng)，但是被平臺(tái)管控受限的H5。
?
入駐閑魚(yú)小程序，必須要部署“聚石塔服務(wù)”嗎？
是的。閑魚(yú)小程序調(diào)用的后端接口，都必須部署到聚石塔上。
?
聚石塔如何接入？
參考文檔：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2參考文檔：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2
?
部署到聚石塔的接口可以調(diào)用外部接口嗎？
可以。聚石塔內(nèi)外互通是通過(guò)奇門(mén)接口實(shí)現(xiàn)的。具體可以參考：聚石塔內(nèi)外互通說(shuō)明。
?
小程序內(nèi)使用的閑魚(yú)賬號(hào)和淘寶開(kāi)發(fā)者賬號(hào)，可以用個(gè)人賬號(hào)嗎？如果是用個(gè)人賬號(hào)，后期還能再變更為公司賬戶...
為保障整體業(yè)務(wù)流暢，請(qǐng)使用與閑魚(yú)簽約的企業(yè)賬號(hào)申請(qǐng)閑魚(yú)賬號(hào)和淘寶開(kāi)發(fā)者賬號(hào)；如果使用個(gè)人賬號(hào)，后期不支持變更，所以推薦使用企業(yè)賬號(hào)。理論上淘寶開(kāi)放平臺(tái)入駐主體 、閑魚(yú)入駐主體、合同簽約主體，三者應(yīng)該一致。為保障整體業(yè)務(wù)流暢，請(qǐng)使用與閑魚(yú)簽約的企業(yè)賬號(hào)申請(qǐng)閑魚(yú)賬號(hào)和淘寶開(kāi)發(fā)者賬號(hào)；如果使用個(gè)人賬號(hào)，后期不支持變更，所以推薦使用企業(yè)賬號(hào)。理論上淘寶開(kāi)放平臺(tái)入駐主體 、閑魚(yú)入駐主體、合同簽約主體，三者應(yīng)該一致。
<
關(guān)于我們
>
閑魚(yú)是中國(guó)領(lǐng)先的二手交易平臺(tái)，隸屬于阿里巴巴集團(tuán)，致力于為用戶提供安全、便捷的二手商品交易服務(wù)。用戶可以通過(guò)閑魚(yú)發(fā)布、購(gòu)買(mǎi)和交換二手商品，同時(shí)享受專業(yè)的售后保障和社區(qū)互動(dòng)功能。閑魚(yú)開(kāi)放平臺(tái)提供豐富的API接口，支持小程序開(kāi)發(fā)者快速接入和發(fā)布集成，為廣大開(kāi)發(fā)者提供了便利的技術(shù)支持和文檔指導(dǎo)。
聯(lián)系信息
服務(wù)時(shí)間： 00:00:00至24:00:00
網(wǎng)頁(yè)在線客服： 咨詢
<
最可能同場(chǎng)景使用的其他API
>