操作步驟

1、當(dāng)渠道方與嚴(yán)選完成合同簽訂后,由嚴(yán)選市場方以郵件形式發(fā)起對接:

主  題:【網(wǎng)易嚴(yán)選API對接】XXX渠道對接
發(fā)件人:嚴(yán)選市場的郵箱地址
收件人:嚴(yán)選技術(shù)的郵箱地址
抄  送:<渠道方抄送郵箱地址>,<嚴(yán)選方抄送郵箱地址>
嚴(yán)選技術(shù):
        你們好。
        XXX渠道現(xiàn)需進(jìn)行API對接,分銷系統(tǒng)已創(chuàng)建相應(yīng)渠道,請嚴(yán)選技術(shù)團(tuán)隊(duì)安排相關(guān)人員協(xié)作完成對接工作。
        渠道方技術(shù)人員:XXX,郵箱:XXX,
        嚴(yán)選方運(yùn)營人員:XXX,郵箱:XXX。
        嚴(yán)選產(chǎn)品與技術(shù)部接受郵件,確認(rèn)需求。

2、嚴(yán)選技術(shù)方收到郵件后,會(huì)提供用于對接的相關(guān)材料,并渠道方測試環(huán)境下的 IP 白名單、統(tǒng)一回調(diào)URL

XXX(渠道名稱):
         你們好。
         我方已收到你方對接申請,《對接流程》、《OpenAPI 對接 Demo》、《常見問題》和《OpenAPI 文檔》等內(nèi)容參見http://open.you.163.com。
         附件為《網(wǎng)易嚴(yán)選OpenAPI標(biāo)準(zhǔn)接口文檔 V1.0.0》,敬請查看。我們將根據(jù)《對接流程》于你方協(xié)作完成 OpenAPI 對接工作。
         現(xiàn)需你方提供一下配置信息:測試環(huán)境 IP 白名單,統(tǒng)一回調(diào) URL,這些配置信息將用于配置嚴(yán)選測試環(huán)境,以便進(jìn)行 OpenAPI 對接的開發(fā)測試。

2.2     申請測試環(huán)境參數(shù)

操作步驟

1、渠道方根據(jù)嚴(yán)選要求,將測試環(huán)境下的IP白名單、統(tǒng)一回調(diào)URL以郵件的形式回復(fù)至嚴(yán)選郵箱:

嚴(yán)選團(tuán)隊(duì):
         嚴(yán)選團(tuán)隊(duì),你們好。以下是我方測試環(huán)境的相關(guān)配置:
         渠道名稱:xxx
         測試環(huán)境IP白名單:xxx
         測試環(huán)境統(tǒng)一回調(diào)URL:xxx
         煩請你方盡快完成測試環(huán)境的相關(guān)配置。

2、嚴(yán)選技術(shù)方配置測試環(huán)境,配置內(nèi)容包括:

1)測試環(huán)境AppKey及AppSecret

2)申請渠道測試IP白名單的外網(wǎng)訪問權(quán)限

3)添加測試SKU

并通過郵件回復(fù)渠道方以下信息

XXX(渠道名稱):
         XXX,你們好。我方已完成測試環(huán)境配置,測試環(huán)境配置如下:
         測試環(huán)境AppKey:xxx
         測試環(huán)境AppSecret:xxx
         請參考《OpenAPI對接Demo》完成API對接的開發(fā)測試工作,請?jiān)谕瓿芍笠脏]件的形式申請進(jìn)行線上環(huán)境對接。

3、如渠道方需要修改測試環(huán)境參數(shù),也需要通過郵件申請。

嚴(yán)選團(tuán)隊(duì):
         嚴(yán)選團(tuán)隊(duì),你們好。現(xiàn)我方申請修改測試環(huán)境的相關(guān)配置:
         渠道名稱:xxx
         修改參數(shù): IP白名單/統(tǒng)一回調(diào)URL
         修改類型:增加/覆蓋
         修改內(nèi)容: xxx
         更新原因:xxx
         煩請你方盡快完成測試環(huán)境的相關(guān)配置。

4、如渠道方需要測試回調(diào)接口,需要通過接口申請權(quán)限(按需申請,最多申請三十天)。

嚴(yán)選團(tuán)隊(duì):
         嚴(yán)選團(tuán)隊(duì),你們好。現(xiàn)我方申請測試測試回調(diào)接口權(quán)限。
         開始時(shí)間: xxx
         結(jié)束時(shí)間:xxx
         煩請你方盡快完成測試環(huán)境的相關(guān)配置。

2.3     測試環(huán)境功能驗(yàn)證

渠道方接入測試環(huán)境后,需要對接功能,并完成以下集成測試:

    1)渠道查詢商品列表→渠道查詢商品信息→渠道維護(hù)渠道展示信息(庫存為0的下架或不可賣)

    2)渠道下單→嚴(yán)選發(fā)貨(訂單綁定)→嚴(yán)選回調(diào)訂單綁定方法→渠道更新訂單信息→渠道確認(rèn)收貨

    3)渠道下單→嚴(yán)選發(fā)貨→渠道取消訂單→取消失敗

    4)渠道下單→渠道取消訂單→訂單取消成功(或失敗)

    5)渠道下單→渠道取消訂單→嚴(yán)選客服審核→嚴(yán)選回調(diào)訂單取消方法

    6)渠道下單→嚴(yán)選回調(diào)異常方法→渠道更新訂單信息

2.4     申請線上環(huán)境參數(shù)

操作步驟

1、渠道方開發(fā)測試完成之后,可以申請接入線上環(huán)境。需要將線上環(huán)境下的IP白名單、統(tǒng)一回調(diào)URL、對接內(nèi)容以郵件的形式發(fā)送至嚴(yán)選郵箱申請。

嚴(yán)選團(tuán)隊(duì):
?         嚴(yán)選團(tuán)隊(duì),你們好。以下是我方線上環(huán)境的相關(guān)配置:
?         渠道名稱:xxx
?         線上環(huán)境IP白名單:xxx
?         線上環(huán)境統(tǒng)一回調(diào)URL:xxx
         對接接口:全部接口(按實(shí)際對接情況填寫)
         對接回調(diào):全部回調(diào)(按實(shí)際對接情況填寫)
?         煩請你方盡快完成線上環(huán)境的相關(guān)配置。

2、嚴(yán)選技術(shù)方審核渠道合同信息,并配置線上環(huán)境,配置內(nèi)容包括:

    1)線上環(huán)境AppKey及AppSecret

    2)IP白名單

    3)統(tǒng)一回調(diào)URL

XXX(渠道名稱):
?     XXX,你們好。我方已完成線上環(huán)境配置,線上環(huán)境配置如下:
?     線上環(huán)境AppKey,AppSecret等參數(shù)已私信已給你方對接開發(fā)。
?     請使用線上環(huán)境SkuID進(jìn)行實(shí)單驗(yàn)證,請?jiān)谕瓿芍笠脏]件的形式申請啟用線上渠道。

3、如渠道方需要修改線上環(huán)境參數(shù),也需要通過郵件申請。

嚴(yán)選團(tuán)隊(duì):
     嚴(yán)選團(tuán)隊(duì),你們好。現(xiàn)我方申請修改線上環(huán)境的相關(guān)配置:
     渠道名稱:xxx
     修改參數(shù): IP白名單/統(tǒng)一回調(diào)URL
     修改類型:增加/覆蓋
     修改內(nèi)容: xxx
     更新原因:xxx
     煩請你方盡快完成線上環(huán)境的相關(guān)配置。

2.5     線上環(huán)境功能驗(yàn)證

1、渠道方根據(jù)嚴(yán)選提供的線上環(huán)境參數(shù),配置渠道方線上環(huán)境,并完成實(shí)單驗(yàn)證

特別強(qiáng)調(diào),線上回歸時(shí)僅可使用測試服測試通過的非壓力測試用例,請務(wù)必遵守以下規(guī)定:

    1)嚴(yán)禁使用未通過測試服測試的用例或新用例,

    2)嚴(yán)禁壓力測試

驗(yàn)證通過之后,渠道方以郵件的形式向嚴(yán)選申請啟用線上渠道

嚴(yán)選團(tuán)隊(duì):
?     嚴(yán)選團(tuán)隊(duì),你們好。我方已完成線上環(huán)境的實(shí)單驗(yàn)證,現(xiàn)申請啟動(dòng)線上渠道。

2、嚴(yán)選技術(shù)審核上線請求

嚴(yán)選審核渠道方線上驗(yàn)證結(jié)果,評估線上渠道啟用風(fēng)險(xiǎn),審核是否啟用線上渠道:

3      郵件規(guī)范

本文中涉及的所有郵件往來,請務(wù)必嚴(yán)格遵照以下四點(diǎn)!

1. 郵件回復(fù)時(shí)請務(wù)必使用回復(fù)全部;

2. 發(fā)件人、收件人郵箱地址在對接開始時(shí)相互進(jìn)行確認(rèn);

3. 收件人請務(wù)必添加嚴(yán)選技術(shù)的郵箱地址;

4. 主題與內(nèi)容請采用指定模板格式

此圖片的 alt 屬性為空;文件名為 image-1370-1024x490.png

2. 接口示例

商品ID查詢接口(yanxuan.item.id.batch.get)

功能描述

獲取渠道能售賣的所有商品(SPU)ID,相關(guān)接入說明參見here。

公共請求參數(shù)

參數(shù)名參數(shù)類型是否必填最大長度描述示例值
methodString/方法名,不同接口傳入相應(yīng)的方法名(即文檔標(biāo)題括號中的英文方法名)
最大長度為固定值
例如:yanxuan.item.id.batch.get
appKeyString/渠道的AppKey,嚴(yán)選提供的渠道方標(biāo)識
最大長度為固定值
7457c00875xxxx7c8c44d0f40d984158
signString/渠道請求參數(shù)的簽名串,詳見簽名。
最大長度為固定值
4001A0E765A4781B1197D9E91A5B9C97
timestampString/請求時(shí)間戳,采用yyyy-MM-dd HH:mm:ss的形式,前后5分鐘內(nèi)的請求為有效請求
最大長度為固定值
2016-05-23 09:00:00

API請求入?yún)?/strong>

公共響應(yīng)參數(shù)

參數(shù)名參數(shù)類型是否必填最大長度描述示例值
codeNumber/狀態(tài)碼,200為成功,其余為失敗,嚴(yán)選返回錯(cuò)誤詳細(xì)信息錯(cuò)誤描述(若為回調(diào)返回,應(yīng)返回成功code200即可)/
msgString/錯(cuò)誤說明,當(dāng)code!=200時(shí)返回,嚴(yán)選返回錯(cuò)誤詳細(xì)信息錯(cuò)誤描述(若為回調(diào)返回,渠道自行定義錯(cuò)誤說明)/
subErrCodeString/子錯(cuò)誤碼,當(dāng)code!=200時(shí)返回/
subErrParamObject/子錯(cuò)誤參數(shù),可選,不一定有該項(xiàng),當(dāng)code!=200時(shí)返回/

API響應(yīng)參數(shù)

參數(shù)名參數(shù)類型是否必填最大長度描述示例值
resultList[Object]/SPU ID10018002

公共參數(shù)錯(cuò)誤碼

錯(cuò)誤碼子錯(cuò)誤碼描述子錯(cuò)誤碼key
404/uri未匹配到任何api,reponse:{“msg”:”no API found with those values”}/
500/內(nèi)部錯(cuò)誤,reponse:{“msg”: “Ianus server error”}/
429/訪問次數(shù)超額,reponse:{“msg”:”API rate limit exceeded”}/
403/請求中沒有sign參數(shù),reponse:{“msg”:”No sign found”}/
403/未找到該租戶的AppSecret,reponse:{“msg”:”No secret found”}/
403/請求中無appKey參數(shù),reponse:{“msg”:”No credential found.”}/
403/請求中無appKey參數(shù),reponse:{“msg”:”No appKey found.”}/
403/簽名不合法,reponse:{“msg”:”Invalid signature”}/
403/IP被攔截,reponse:{“msg”:”Client IP address is not allowed”}/
400/參數(shù)不合法,reponse:{“msg”:”Invalid input: ${參數(shù)名}=${參數(shù)值}”}/
10016isv.dependent-service-failed方法:{method}的依賴服務(wù)錯(cuò)誤,相關(guān)信息如下:{errString}method,errString,traceId
19999isp.system-error系統(tǒng)處理錯(cuò)誤,具體錯(cuò)誤信息(任意)待明確traceId
20001isv.business-missing-param缺少參數(shù):{param}param,traceId
20002isv.business-invalid-param參數(shù):{param}值非法param,traceId
20003isv.business-param-json-error參數(shù):{param}值執(zhí)行json解析失敗param,traceId
20004isv.business-invalid-param-detail參數(shù):{param}值非法。原因:{detail}param,detail,traceId
20005isv.business-param-length-error參數(shù):{param}長度錯(cuò)誤。原因:{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&timestamp=2018-12-24 16:33:38&sign=60F05EE66CB7AF757C96CD6DD8CB5508'

響應(yīng)示例

{
"code": 200,
"msg": "",
"result": [
0
]
}

3. 常見問題

Q:如何找到網(wǎng)易嚴(yán)選 API

A:冪簡集成是國內(nèi)領(lǐng)先的API集成管理平臺(tái),專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺(tái)可以通過以下兩種方式找到所需API:通過關(guān)鍵詞搜索API(例如,輸入’網(wǎng)易嚴(yán)選 API‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁進(jìn)入尋找。

Q:輸出參數(shù)說明
A:

采用json的編碼格式

頻率限制:單個(gè)接口一分鐘的時(shí)間段內(nèi)(開始時(shí)間任意)請求不能超過70次

sign(簽名,簽名的生成規(guī)則如下)【建議使用demo內(nèi)提供的簽名方法】

1)輸入?yún)?shù)值(除sign外)參照字母排序拼接,拼接成key=value的字符串形式

2)首尾加上appSecret值

3)最后對上述值取32位大寫MD5值

Q:請求錯(cuò)誤?
A:檢查發(fā)送的HTTP請求是否正確,包括URL和參數(shù)。確保使用了正確的API端點(diǎn)URL,并將所需的參數(shù)作為查詢參數(shù)或請求體的一部分發(fā)送。

Q:輸入?yún)?shù)說明
A:

示例如下:

key=value&key1=value1….

Q:接口頻率
A:接口調(diào)用頻率:每分鐘不超過120次。注意:批量拉取商品信息、通過商品變更回調(diào)批量上架商品時(shí),注意頻率問題,防止超頻報(bào)錯(cuò)。

Q:網(wǎng)易嚴(yán)選 API的替代品有哪些?

提供AI大模型API的服務(wù)商除了網(wǎng)易嚴(yán)選 API,還有其他替代服務(wù)商也提供類似api服務(wù),例如:

Telenor API開放平臺(tái)小紅書 API開放平臺(tái)蘑菇街 API開放平臺(tái)

更多競品可以在冪簡集成開放平臺(tái)中找到。

Q:網(wǎng)易嚴(yán)選 API這個(gè)密鑰還適用于哪些api?

商品信息查詢接口商品類目信息接口查詢SKU對應(yīng)商品信息接口

4.  總結(jié)

本文全面且細(xì)致地總結(jié)了獲取網(wǎng)易嚴(yán)選API開放平臺(tái)訪問token的完整流程,為電商應(yīng)用開發(fā)者們提供了一份條理清晰、操作簡便的分步指南。從初始的網(wǎng)易嚴(yán)選API開放平臺(tái)賬號注冊,到完成開發(fā)者身份驗(yàn)證,再到最終成功取得訪問token,每一步都輔以詳盡的說明與指導(dǎo),旨在確保開發(fā)者們能夠輕松、順利地完成整個(gè)流程。在成功獲取訪問token后,本文還著重強(qiáng)調(diào)了進(jìn)行可用性測試的重要性。這一步驟對于確保API能夠無縫集成到電商應(yīng)用中,并發(fā)揮出最佳效能至關(guān)重要。通過測試,開發(fā)者們可以及時(shí)發(fā)現(xiàn)并解決可能存在的問題,為后續(xù)的電商應(yīng)用開發(fā)奠定堅(jiān)實(shí)的基礎(chǔ)。本文不僅為開發(fā)者們提供了一份詳盡的指南,更為他們順利獲取并有效利用網(wǎng)易嚴(yán)選API開放平臺(tái)資源提供了強(qiáng)有力的支持。這不僅有助于提升電商應(yīng)用的性能和用戶體驗(yàn),更將進(jìn)一步推動(dòng)電商領(lǐng)域的數(shù)字化創(chuàng)新與發(fā)展,助力企業(yè)在激烈的市場競爭中脫穎而出。

#你可能也喜歡這些API文章!

我們有何不同?

API服務(wù)商零注冊

多API并行試用

數(shù)據(jù)驅(qū)動(dòng)選型,提升決策效率

查看全部API→
??

熱門場景實(shí)測,選對API

#AI文本生成大模型API

對比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個(gè)渠道
一鍵對比試用API 限時(shí)免費(fèi)

#AI深度推理大模型API

對比大模型API的邏輯推理準(zhǔn)確性、分析深度、可視化建議合理性

10個(gè)渠道
一鍵對比試用API 限時(shí)免費(fèi)