閑魚開放平臺

閑魚開放平臺

專用API
【更新時間: 2024.08.15】 閑魚開放平臺是阿里巴巴集團旗下閑魚項目的開放接口平臺，專為開發者提供技術支持和服務。通過開放的閑魚API，幫助開發者快速集成閑魚的多種功能。無論是商品發布、訂單管理還是用戶互動，閑魚API都能為開發者提供便捷的解決方案。
瀏覽次數
304
采購人數
10
試用次數
3
! SLA: N/A
! 響應: N/A
! 適用于個人&企業
試用
收藏
×
完成
取消
×
書簽名稱
確定
<
產品介紹
>

什么是閑魚開放平臺?

該服務是為閑魚小程序合作方提供的服務端接入文檔，詳細說明了如何在聚石塔環境中部署服務端服務，如何進行用戶登錄授權，以及如何使用閑魚提供的API進行訂單管理和用戶信息查詢等操作。文檔提供了詳細的API列表、消息匯總、API調用身份說明、TOPAPI環境地址確認、權限申請流程以及部分API的詳細說明，旨在幫助合作方快速接入閑魚平臺，實現業務的自動化和智能化管理。

什么是閑魚開放平臺接口？

由服務使用方的應用程序發起，以Restful風格為主、通過公網HTTP協議調用閑魚開放平臺，從而實現程序的自動化交互，提高服務效率。

閑魚開放平臺有哪些核心功能？

  1. 訂單創建：服務商可以通過TOP接口調用創單API創建閑魚訂單
  2. 發貨接口-虛擬發貨：該接口適用于無需物流發貨的場景。對應創單時不需要傳入deliver_id的情況。
  3. 發貨接口-有物流發貨：有實物物流的發貨場景，對應創單時需要傳入deliver_id的情況
  4. 物流公司編碼查詢：通過該接口可以查詢支持的物流公司編碼。
  5. 逆向訂單查詢：該接口用于查詢用戶退貨、換貨等逆向訂單信息。
  6. 正向訂單查詢：該接口用于查詢用戶購買的正向訂單信息。
  7. 退款單處理：通過該接口可以處理用戶的退款申請。
  8. 服務商主動取消訂單（未發貨）：服務商在訂單未發貨的情況下，可以通過該接口主動取消訂單。
  9. 正向訂單變更消息：該接口用于查詢或監聽正向訂單的變更消息。
  10. 逆向訂單變更消息：該接口用于查詢或監聽逆向訂單的變更消息。
  11. 用戶基礎信息（性別、頭像、昵稱）：該接口用于獲取用戶的基礎信息，包括性別、頭像和昵稱。

閑魚開放平臺的核心優勢是什么？

 

  1. 豐富的功能接口：閑魚開放平臺提供了多種接口，覆蓋商品管理、訂單處理、用戶管理等各個方面，滿足開發者的多樣化需求。
  2. 高效的開發支持：平臺提供詳細的開發文檔和技術支持，幫助開發者快速上手并高效完成開發任務。
  3. 穩定的系統性能：作為阿里巴巴旗下產品，閑魚開放平臺擁有強大的技術底蘊和穩定的系統性能，確保開發者在使用過程中能夠獲得良好的體驗。

 

在哪些場景會用到閑魚開放平臺？

電商平臺的二手商品專區：一個大型電商平臺想要增加一個二手商品交易專區，可以通過閑魚開放平臺的接口，將商品發布、訂單管理等功能接入到自己的平臺中，從而為用戶提供一個可靠的二手商品交易服務。

 

 
社交媒體的二手交易功能：一個社交媒體平臺希望增加用戶互動的多樣性，決定增加二手交易功能。通過閑魚開放平臺的用戶管理和商品發布接口，可以讓用戶在社交平臺上直接發布和管理自己的二手商品，增強平臺的用戶粘性。

 
二手商品市場分析：在電商平臺上，二手商品市場的需求不斷增長。利用“閑魚開放平臺”API接口，商家可以實時獲取閑魚上的商品信息，如價格、銷量和用戶評論。這些數據可以幫助商家分析市場趨勢、制定定價策略以及優化庫存管理。

 
<
使用指南
>

服務API使用指南

1. 環境準備

1.1 聚石塔接入

  • 所有服務端服務必須部署在聚石塔內。

  • 用戶ID、訂單信息需存儲在聚石塔數據庫中。

  • 訪問聚石塔外部資源需要審批。

1.2 相關文檔

2. 用戶登錄授權

2.1 授權流程

  1. 前端獲取授權碼（code）。

  2. 服務器使用code和AppSecret調用taobao.top.auth.token.create接口換取accessToken。

  3. accessToken用于后續請求TOP接口。

2.2 注意事項

  • 授權碼僅能使用一次，需重新獲取。

  • accessToken在過期之前無需重新獲取。

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

3. API調用

3.1 API匯總

  • 訂單創建: alibaba.idle.isv.goosefish.order.create

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

  • 虛擬發貨: alibaba.idle.isv.goosefish.virtual.delivery

  • 物流發貨: alibaba.idle.isv.order.ship

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

  • 發貨前關閉訂單: alibaba.idle.isv.order.close

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

  • 發貨后退款關單: alibaba.idle.isv.order.after.send.refund

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

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

  • 用戶基礎信息: alibaba.idle.goosefish.user.info.query

3.2 消息匯總

  • 正向交易消息: idle_autotrade_OrderStateSync

  • 逆向交易消息: idle_autotrade_RefundSync

4. API調用身份說明

  • 訂單創建和用戶基礎信息接口需使用當前登錄用戶的accessToken。

  • 其他涉及賣家的接口需使用賣家的accessToken。

5. TOPAPI 環境地址

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

  • 預發地址: https://pre-gw.api.taobao.com/top/router/rest（僅在閑魚側更新或新增時使用）

5.1 預發聯調

  • 在聯調前聯系閑魚開發同學開通預發環境聯調權限。

6. 權限申請

  • 在閑魚三方開發平臺發起API權限申請，確保只申請必要的API。

7. 部分API詳細說明

7.1 訂單創建

  • 調用alibaba.idle.isv.goosefish.order.create創建閑魚訂單。

7.2 訂單查詢

  • 使用alibaba.idle.isv.order.query查詢訂單狀態。

7.3 發貨接口

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

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

7.4 逆向訂單查詢

  • 使用alibaba.idle.isv.refund.query查詢退款狀態。

7.5 退款處理

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

8. 消息處理

  • 監聽idle_autotrade_OrderStateSync和idle_autotrade_RefundSync消息以獲取訂單狀態變化。

通過以上步驟，用戶可以順利對接和集成服務API。

 

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

<
產品問答
>
?
初次接入小程序，需要申請哪些權限?
權限分為客戶端接口權限和服務端接口權限，需要在管理平臺上申請權限后才能使用。具體可以參考【小程序快速接入】申請API權限
?
小程序對瀏覽器API支持是否完整；在SPA應用下，是否支持History模式？
都支持的。閑魚小程序可以理解為一個能力增強，但是被平臺管控受限的H5。都支持的。閑魚小程序可以理解為一個能力增強，但是被平臺管控受限的H5。
?
入駐閑魚小程序，必須要部署“聚石塔服務”嗎？
是的。閑魚小程序調用的后端接口，都必須部署到聚石塔上。
?
聚石塔如何接入？
參考文檔：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
?
部署到聚石塔的接口可以調用外部接口嗎？
可以。聚石塔內外互通是通過奇門接口實現的。具體可以參考：聚石塔內外互通說明。
?
小程序內使用的閑魚賬號和淘寶開發者賬號，可以用個人賬號嗎？如果是用個人賬號，后期還能再變更為公司賬戶...
為保障整體業務流暢，請使用與閑魚簽約的企業賬號申請閑魚賬號和淘寶開發者賬號；如果使用個人賬號，后期不支持變更，所以推薦使用企業賬號。理論上淘寶開放平臺入駐主體 、閑魚入駐主體、合同簽約主體，三者應該一致。為保障整體業務流暢，請使用與閑魚簽約的企業賬號申請閑魚賬號和淘寶開發者賬號；如果使用個人賬號，后期不支持變更，所以推薦使用企業賬號。理論上淘寶開放平臺入駐主體 、閑魚入駐主體、合同簽約主體，三者應該一致。
<
關于我們
>
閑魚是中國領先的二手交易平臺，隸屬于阿里巴巴集團，致力于為用戶提供安全、便捷的二手商品交易服務。用戶可以通過閑魚發布、購買和交換二手商品，同時享受專業的售后保障和社區互動功能。閑魚開放平臺提供豐富的API接口，支持小程序開發者快速接入和發布集成，為廣大開發者提供了便利的技術支持和文檔指導。
聯系信息
服務時間： 00:00:00至24:00:00
網頁在線客服： 咨詢
<
最可能同場景使用的其他API
>
API接口列表
<
使用指南
>

服務API使用指南

1. 環境準備

1.1 聚石塔接入

  • 所有服務端服務必須部署在聚石塔內。

  • 用戶ID、訂單信息需存儲在聚石塔數據庫中。

  • 訪問聚石塔外部資源需要審批。

1.2 相關文檔

2. 用戶登錄授權

2.1 授權流程

  1. 前端獲取授權碼（code）。

  2. 服務器使用code和AppSecret調用taobao.top.auth.token.create接口換取accessToken。

  3. accessToken用于后續請求TOP接口。

2.2 注意事項

  • 授權碼僅能使用一次，需重新獲取。

  • accessToken在過期之前無需重新獲取。

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

3. API調用

3.1 API匯總

  • 訂單創建: alibaba.idle.isv.goosefish.order.create

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

  • 虛擬發貨: alibaba.idle.isv.goosefish.virtual.delivery

  • 物流發貨: alibaba.idle.isv.order.ship

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

  • 發貨前關閉訂單: alibaba.idle.isv.order.close

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

  • 發貨后退款關單: alibaba.idle.isv.order.after.send.refund

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

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

  • 用戶基礎信息: alibaba.idle.goosefish.user.info.query

3.2 消息匯總

  • 正向交易消息: idle_autotrade_OrderStateSync

  • 逆向交易消息: idle_autotrade_RefundSync

4. API調用身份說明

  • 訂單創建和用戶基礎信息接口需使用當前登錄用戶的accessToken。

  • 其他涉及賣家的接口需使用賣家的accessToken。

5. TOPAPI 環境地址

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

  • 預發地址: https://pre-gw.api.taobao.com/top/router/rest（僅在閑魚側更新或新增時使用）

5.1 預發聯調

  • 在聯調前聯系閑魚開發同學開通預發環境聯調權限。

6. 權限申請

  • 在閑魚三方開發平臺發起API權限申請，確保只申請必要的API。

7. 部分API詳細說明

7.1 訂單創建

  • 調用alibaba.idle.isv.goosefish.order.create創建閑魚訂單。

7.2 訂單查詢

  • 使用alibaba.idle.isv.order.query查詢訂單狀態。

7.3 發貨接口

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

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

7.4 逆向訂單查詢

  • 使用alibaba.idle.isv.refund.query查詢退款狀態。

7.5 退款處理

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

8. 消息處理

  • 監聽idle_autotrade_OrderStateSync和idle_autotrade_RefundSync消息以獲取訂單狀態變化。

通過以上步驟，用戶可以順利對接和集成服務API。

 

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

<
依賴服務
>
<
產品問答
>
?
初次接入小程序，需要申請哪些權限?
權限分為客戶端接口權限和服務端接口權限，需要在管理平臺上申請權限后才能使用。具體可以參考【小程序快速接入】申請API權限
?
小程序對瀏覽器API支持是否完整；在SPA應用下，是否支持History模式？
都支持的。閑魚小程序可以理解為一個能力增強，但是被平臺管控受限的H5。都支持的。閑魚小程序可以理解為一個能力增強，但是被平臺管控受限的H5。
?
入駐閑魚小程序，必須要部署“聚石塔服務”嗎？
是的。閑魚小程序調用的后端接口，都必須部署到聚石塔上。
?
聚石塔如何接入？
參考文檔：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
?
部署到聚石塔的接口可以調用外部接口嗎？
可以。聚石塔內外互通是通過奇門接口實現的。具體可以參考：聚石塔內外互通說明。
?
小程序內使用的閑魚賬號和淘寶開發者賬號，可以用個人賬號嗎？如果是用個人賬號，后期還能再變更為公司賬戶...
為保障整體業務流暢，請使用與閑魚簽約的企業賬號申請閑魚賬號和淘寶開發者賬號；如果使用個人賬號，后期不支持變更，所以推薦使用企業賬號。理論上淘寶開放平臺入駐主體 、閑魚入駐主體、合同簽約主體，三者應該一致。為保障整體業務流暢，請使用與閑魚簽約的企業賬號申請閑魚賬號和淘寶開發者賬號；如果使用個人賬號，后期不支持變更，所以推薦使用企業賬號。理論上淘寶開放平臺入駐主體 、閑魚入駐主體、合同簽約主體，三者應該一致。
<
關于我們
>
閑魚是中國領先的二手交易平臺，隸屬于阿里巴巴集團，致力于為用戶提供安全、便捷的二手商品交易服務。用戶可以通過閑魚發布、購買和交換二手商品，同時享受專業的售后保障和社區互動功能。閑魚開放平臺提供豐富的API接口，支持小程序開發者快速接入和發布集成，為廣大開發者提供了便利的技術支持和文檔指導。
聯系信息
服務時間： 00:00:00至24:00:00
網頁在線客服： 咨詢