閑魚開放平臺

閑魚開放平臺

專用API
【更新時間: 2024.07.29】 閑魚開放平臺是阿里巴巴集團旗下閑魚項目的開放接口平臺，專為開發者提供全面的技術支持和服務。該平臺通過開放API接口，幫助開發者快速集成閑魚的多種功能
瀏覽次數
2.3K
采購人數
1
試用次數
1
! SLA: N/A
! 響應: N/A
! 適用于個人&企業
試用
收藏
×
完成
取消
×
書簽名稱
確定
<
產品介紹
>

什么是閑魚開放平臺?

通過該平臺，開發者可以接入閑魚的各種服務和數據，從而實現二手交易、物品發布、用戶管理等多種功能。這不僅提升了開發者的開發效率，也增強了與閑魚的生態連接，使得用戶能夠在閑魚上進行更豐富多樣的操作。

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

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

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

 

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

 

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

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

 

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

 
 

 

 
<
使用指南
>

1. 環境準備-聚石塔接入

由于集團安全規則，需接入聚石塔后進行調用，用戶id、訂單信息等必須存儲在聚石塔內的數據庫中，因此需要將服務端的服務均部署在聚石塔內。

相關文檔：聚石塔-入塔指南

聚石塔外是可以訪問塔內。聚石塔內如果需要訪問塔外，需要走審批。 參考文檔： 奇門自定義API場景接入流程

2. 用戶登錄授權

授權登錄是采?淘寶開放平臺auth2.0?式進?的，前端的主要?作是獲取授權碼（code），由服務器端通過code 和應用密鑰（AppSecret）調用taobao.top.auth.token.create這個top接口換取accessToken、token的過期時間和?戶uid等信息。該accessToken可以用來后續請求TOP接口。

目前新接入的小程序，可以直接使用客戶端API用戶授權，直接獲取授權碼（code），不需要跳轉到回調地址。

注意：授權碼（code）僅能使??次，如果已經使?則需要重新獲取。

另外，在accessToken過期之前，不需要重新獲取授權碼。因此在第一次登錄授權后，小程序可以生成自己的cookie，緩存在客戶端內（閑魚提供了setStorage和getStorage兩個API）。避免同一用戶每次進入小程序都重新獲取code，否則可能會被限流。

整體流程如下：

image

注意： 1.授權碼（code）僅能使??次，如果已經使?則需要重新獲取。

【接口】：taobao.top.auth.token.create

【入參】：

字段 類型 介紹
code String 授權code，前端組件獲取到的code

詳情參考：https://open.goofish.com/doc/development/dev/server.html#1-%E7%8E%AF%E5%A2%83%E5%87%86%E5%A4%87-%E8%81%9A%E7%9F%B3%E5%A1%94%E6%8E%A5%E5%85%A5

 

<
產品問答
>
?
初次接入小程序，需要申請哪些權限?
權限分為客戶端接口權限和服務端接口權限，需要在管理平臺上申請權限后才能使用。具體可以參考【小程序快速接入】申請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接口列表
<
使用指南
>

1. 環境準備-聚石塔接入

由于集團安全規則，需接入聚石塔后進行調用，用戶id、訂單信息等必須存儲在聚石塔內的數據庫中，因此需要將服務端的服務均部署在聚石塔內。

相關文檔：聚石塔-入塔指南

聚石塔外是可以訪問塔內。聚石塔內如果需要訪問塔外，需要走審批。 參考文檔： 奇門自定義API場景接入流程

2. 用戶登錄授權

授權登錄是采?淘寶開放平臺auth2.0?式進?的，前端的主要?作是獲取授權碼（code），由服務器端通過code 和應用密鑰（AppSecret）調用taobao.top.auth.token.create這個top接口換取accessToken、token的過期時間和?戶uid等信息。該accessToken可以用來后續請求TOP接口。

目前新接入的小程序，可以直接使用客戶端API用戶授權，直接獲取授權碼（code），不需要跳轉到回調地址。

注意：授權碼（code）僅能使??次，如果已經使?則需要重新獲取。

另外，在accessToken過期之前，不需要重新獲取授權碼。因此在第一次登錄授權后，小程序可以生成自己的cookie，緩存在客戶端內（閑魚提供了setStorage和getStorage兩個API）。避免同一用戶每次進入小程序都重新獲取code，否則可能會被限流。

整體流程如下：

image

注意： 1.授權碼（code）僅能使??次，如果已經使?則需要重新獲取。

【接口】：taobao.top.auth.token.create

【入參】：

字段 類型 介紹
code String 授權code，前端組件獲取到的code

詳情參考：https://open.goofish.com/doc/development/dev/server.html#1-%E7%8E%AF%E5%A2%83%E5%87%86%E5%A4%87-%E8%81%9A%E7%9F%B3%E5%A1%94%E6%8E%A5%E5%85%A5

 

<
依賴服務
>
<
產品問答
>
?
初次接入小程序，需要申請哪些權限?
權限分為客戶端接口權限和服務端接口權限，需要在管理平臺上申請權限后才能使用。具體可以參考【小程序快速接入】申請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
網頁在線客服： 咨詢