最適合小型企業的SEO API，專家解答
操作步驟
1、當渠道方與嚴選完成合同簽訂后，由嚴選市場方以郵件形式發起對接：
| 主 題：【網易嚴選API對接】XXX渠道對接 發件人：嚴選市場的郵箱地址 收件人：嚴選技術的郵箱地址 抄 送：<渠道方抄送郵箱地址>,<嚴選方抄送郵箱地址> 嚴選技術： 你們好。 XXX渠道現需進行API對接，分銷系統已創建相應渠道，請嚴選技術團隊安排相關人員協作完成對接工作。 渠道方技術人員：XXX，郵箱：XXX， 嚴選方運營人員：XXX，郵箱：XXX。 嚴選產品與技術部接受郵件，確認需求。 |
2、嚴選技術方收到郵件后，會提供用于對接的相關材料，并渠道方測試環境下的 IP 白名單、統一回調URL
| XXX（渠道名稱）： 你們好。 我方已收到你方對接申請，《對接流程》、《OpenAPI 對接 Demo》、《常見問題》和《OpenAPI 文檔》等內容參見http://open.you.163.com。 附件為《網易嚴選OpenAPI標準接口文檔 V1.0.0》，敬請查看。我們將根據《對接流程》于你方協作完成 OpenAPI 對接工作。 現需你方提供一下配置信息:測試環境 IP 白名單，統一回調 URL，這些配置信息將用于配置嚴選測試環境，以便進行 OpenAPI 對接的開發測試。 |
2.2 申請測試環境參數
操作步驟
1、渠道方根據嚴選要求，將測試環境下的IP白名單、統一回調URL以郵件的形式回復至嚴選郵箱：
| 嚴選團隊： 嚴選團隊，你們好。以下是我方測試環境的相關配置： 渠道名稱：xxx 測試環境IP白名單：xxx 測試環境統一回調URL：xxx 煩請你方盡快完成測試環境的相關配置。 |
2、嚴選技術方配置測試環境，配置內容包括：
1）測試環境AppKey及AppSecret
2）申請渠道測試IP白名單的外網訪問權限
3）添加測試SKU
并通過郵件回復渠道方以下信息
| XXX（渠道名稱）： XXX，你們好。我方已完成測試環境配置，測試環境配置如下： 測試環境AppKey：xxx 測試環境AppSecret：xxx 請參考《OpenAPI對接Demo》完成API對接的開發測試工作，請在完成之后以郵件的形式申請進行線上環境對接。 |
3、如渠道方需要修改測試環境參數，也需要通過郵件申請。
| 嚴選團隊： 嚴選團隊，你們好。現我方申請修改測試環境的相關配置： 渠道名稱：xxx 修改參數: IP白名單/統一回調URL 修改類型：增加/覆蓋 修改內容: xxx 更新原因：xxx 煩請你方盡快完成測試環境的相關配置。 |
4、如渠道方需要測試回調接口，需要通過接口申請權限（按需申請，最多申請三十天）。
| 嚴選團隊： 嚴選團隊，你們好。現我方申請測試測試回調接口權限。 開始時間: xxx 結束時間：xxx 煩請你方盡快完成測試環境的相關配置。 |
2.3 測試環境功能驗證
渠道方接入測試環境后，需要對接功能，并完成以下集成測試：
1）渠道查詢商品列表→渠道查詢商品信息→渠道維護渠道展示信息（庫存為0的下架或不可賣）
2）渠道下單→嚴選發貨(訂單綁定)→嚴選回調訂單綁定方法→渠道更新訂單信息→渠道確認收貨
3）渠道下單→嚴選發貨→渠道取消訂單→取消失敗
4）渠道下單→渠道取消訂單→訂單取消成功（或失敗）
5）渠道下單→渠道取消訂單→嚴選客服審核→嚴選回調訂單取消方法
6）渠道下單→嚴選回調異常方法→渠道更新訂單信息
2.4 申請線上環境參數
操作步驟
1、渠道方開發測試完成之后，可以申請接入線上環境。需要將線上環境下的IP白名單、統一回調URL、對接內容以郵件的形式發送至嚴選郵箱申請。
| 嚴選團隊： ? 嚴選團隊，你們好。以下是我方線上環境的相關配置： ? 渠道名稱：xxx ? 線上環境IP白名單：xxx ? 線上環境統一回調URL：xxx 對接接口：全部接口（按實際對接情況填寫） 對接回調：全部回調（按實際對接情況填寫） ? 煩請你方盡快完成線上環境的相關配置。 |
2、嚴選技術方審核渠道合同信息，并配置線上環境，配置內容包括：
1）線上環境AppKey及AppSecret
2）IP白名單
3）統一回調URL
| XXX（渠道名稱）： ? XXX，你們好。我方已完成線上環境配置，線上環境配置如下： ? 線上環境AppKey，AppSecret等參數已私信已給你方對接開發。 ? 請使用線上環境SkuID進行實單驗證，請在完成之后以郵件的形式申請啟用線上渠道。 |
3、如渠道方需要修改線上環境參數，也需要通過郵件申請。
| 嚴選團隊： 嚴選團隊，你們好。現我方申請修改線上環境的相關配置： 渠道名稱：xxx 修改參數: IP白名單/統一回調URL 修改類型：增加/覆蓋 修改內容: xxx 更新原因：xxx 煩請你方盡快完成線上環境的相關配置。 |
2.5 線上環境功能驗證
1、渠道方根據嚴選提供的線上環境參數，配置渠道方線上環境，并完成實單驗證
特別強調，線上回歸時僅可使用測試服測試通過的非壓力測試用例，請務必遵守以下規定：
1）嚴禁使用未通過測試服測試的用例或新用例，
2）嚴禁壓力測試
驗證通過之后，渠道方以郵件的形式向嚴選申請啟用線上渠道
| 嚴選團隊： ? 嚴選團隊，你們好。我方已完成線上環境的實單驗證，現申請啟動線上渠道。 |
2、嚴選技術審核上線請求
嚴選審核渠道方線上驗證結果，評估線上渠道啟用風險，審核是否啟用線上渠道：
3 郵件規范
本文中涉及的所有郵件往來，請務必嚴格遵照以下四點！
1. 郵件回復時請務必使用回復全部；
2. 發件人、收件人郵箱地址在對接開始時相互進行確認；
3. 收件人請務必添加嚴選技術的郵箱地址；
4. 主題與內容請采用指定模板格式
商品ID查詢接口（yanxuan.item.id.batch.get）
功能描述
獲取渠道能售賣的所有商品（SPU）ID，相關接入說明參見here。
公共請求參數
| 參數名 | 參數類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| method | String | 是 | / | 方法名，不同接口傳入相應的方法名（即文檔標題括號中的英文方法名） 最大長度為固定值 | 例如：yanxuan.item.id.batch.get |
| appKey | String | 是 | / | 渠道的AppKey，嚴選提供的渠道方標識 最大長度為固定值 | 7457c00875xxxx7c8c44d0f40d984158 |
| sign | String | 是 | / | 渠道請求參數的簽名串，詳見簽名。 最大長度為固定值 | 4001A0E765A4781B1197D9E91A5B9C97 |
| timestamp | String | 是 | / | 請求時間戳，采用yyyy-MM-dd HH:mm:ss的形式，前后5分鐘內的請求為有效請求 最大長度為固定值 | 2016-05-23 09:00:00 |
API請求入參
公共響應參數
| 參數名 | 參數類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | Number | 是 | / | 狀態碼，200為成功，其余為失敗，嚴選返回錯誤詳細信息錯誤描述（若為回調返回，應返回成功code200即可） | / |
| msg | String | 否 | / | 錯誤說明，當code!=200時返回，嚴選返回錯誤詳細信息錯誤描述（若為回調返回，渠道自行定義錯誤說明） | / |
| subErrCode | String | 否 | / | 子錯誤碼，當code!=200時返回 | / |
| subErrParam | Object | 否 | / | 子錯誤參數，可選，不一定有該項，當code!=200時返回 | / |
API響應參數
| 參數名 | 參數類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| result | List[Object] | 是 | / | SPU ID | 10018002 |
公共參數錯誤碼
| 錯誤碼 | 子錯誤碼 | 描述 | 子錯誤碼key |
|---|---|---|---|
| 404 | / | uri未匹配到任何api,reponse:{“msg”:”no API found with those values”} | / |
| 500 | / | 內部錯誤,reponse:{“msg”: “Ianus server error”} | / |
| 429 | / | 訪問次數超額,reponse:{“msg”:”API rate limit exceeded”} | / |
| 403 | / | 請求中沒有sign參數,reponse:{“msg”:”No sign found”} | / |
| 403 | / | 未找到該租戶的AppSecret,reponse:{“msg”:”No secret found”} | / |
| 403 | / | 請求中無appKey參數,reponse:{“msg”:”No credential found.”} | / |
| 403 | / | 請求中無appKey參數,reponse:{“msg”:”No appKey found.”} | / |
| 403 | / | 簽名不合法,reponse:{“msg”:”Invalid signature”} | / |
| 403 | / | IP被攔截,reponse:{“msg”:”Client IP address is not allowed”} | / |
| 400 | / | 參數不合法,reponse:{“msg”:”Invalid input: ${參數名}=${參數值}”} | / |
| 10016 | isv.dependent-service-failed | 方法:{method}的依賴服務錯誤,相關信息如下:{errString} | method,errString,traceId |
| 19999 | isp.system-error | 系統處理錯誤，具體錯誤信息（任意）待明確 | traceId |
| 20001 | isv.business-missing-param | 缺少參數:{param} | param,traceId |
| 20002 | isv.business-invalid-param | 參數:{param}值非法 | param,traceId |
| 20003 | isv.business-param-json-error | 參數:{param}值執行json解析失敗 | param,traceId |
| 20004 | isv.business-invalid-param-detail | 參數:{param}值非法。原因:{detail} | param,detail,traceId |
| 20005 | isv.business-param-length-error | 參數:{param}長度錯誤。原因:{detail} | param,detail,traceId |
請求示例
curl -H "Content-Type:application/x-www-form-urlencoded" -X POST 'http://openapi-test.you.163.com/channel/api.json' -d 'appKey=e84220171b484d6598cd083ff9bbfbc9&method=yanxuan.item.id.batch.get×tamp=2018-12-24 16:33:38&sign=60F05EE66CB7AF757C96CD6DD8CB5508'響應示例
{
"code": 200,
"msg": "",
"result": [
0
]
}Q：如何找到網易嚴選 API
A：冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’網易嚴選 API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。
Q：輸出參數說明
A：
采用json的編碼格式
頻率限制：單個接口一分鐘的時間段內（開始時間任意）請求不能超過70次
sign（簽名，簽名的生成規則如下）【建議使用demo內提供的簽名方法】
1）輸入參數值（除sign外）參照字母排序拼接，拼接成key=value的字符串形式
2）首尾加上appSecret值
3）最后對上述值取32位大寫MD5值
Q：請求錯誤？
A：檢查發送的HTTP請求是否正確，包括URL和參數。確保使用了正確的API端點URL，并將所需的參數作為查詢參數或請求體的一部分發送。
Q：輸入參數說明
A：
示例如下：
key=value&key1=value1….
Q：接口頻率
A：接口調用頻率：每分鐘不超過120次。注意：批量拉取商品信息、通過商品變更回調批量上架商品時，注意頻率問題，防止超頻報錯。
提供AI大模型API的服務商除了網易嚴選 API，還有其他替代服務商也提供類似api服務，例如：
Telenor API開放平臺、小紅書 API開放平臺、蘑菇街 API開放平臺
更多競品可以在冪簡集成開放平臺中找到。
Q：網易嚴選 API這個密鑰還適用于哪些api？
商品信息查詢接口、商品類目信息接口、查詢SKU對應商品信息接口
本文全面且細致地總結了獲取網易嚴選API開放平臺訪問token的完整流程，為電商應用開發者們提供了一份條理清晰、操作簡便的分步指南。從初始的網易嚴選API開放平臺賬號注冊，到完成開發者身份驗證，再到最終成功取得訪問token，每一步都輔以詳盡的說明與指導，旨在確保開發者們能夠輕松、順利地完成整個流程。在成功獲取訪問token后，本文還著重強調了進行可用性測試的重要性。這一步驟對于確保API能夠無縫集成到電商應用中，并發揮出最佳效能至關重要。通過測試，開發者們可以及時發現并解決可能存在的問題，為后續的電商應用開發奠定堅實的基礎。本文不僅為開發者們提供了一份詳盡的指南，更為他們順利獲取并有效利用網易嚴選API開放平臺資源提供了強有力的支持。這不僅有助于提升電商應用的性能和用戶體驗，更將進一步推動電商領域的數字化創新與發展，助力企業在激烈的市場競爭中脫穎而出。
