
最適合小型企業(yè)的SEO API,專家解答
操作步驟
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)容請采用指定模板格式
商品ID查詢接口(yanxuan.item.id.batch.get)
功能描述
獲取渠道能售賣的所有商品(SPU)ID,相關(guān)接入說明參見here。
公共請求參數(shù)
參數(shù)名 | 參數(shù)類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
---|---|---|---|---|---|
method | String | 是 | / | 方法名,不同接口傳入相應(yīng)的方法名(即文檔標(biāo)題括號中的英文方法名) 最大長度為固定值 | 例如:yanxuan.item.id.batch.get |
appKey | String | 是 | / | 渠道的AppKey,嚴(yán)選提供的渠道方標(biāo)識 最大長度為固定值 | 7457c00875xxxx7c8c44d0f40d984158 |
sign | String | 是 | / | 渠道請求參數(shù)的簽名串,詳見簽名。 最大長度為固定值 | 4001A0E765A4781B1197D9E91A5B9C97 |
timestamp | String | 是 | / | 請求時(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ù)類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
---|---|---|---|---|---|
code | Number | 是 | / | 狀態(tài)碼,200為成功,其余為失敗,嚴(yán)選返回錯(cuò)誤詳細(xì)信息錯(cuò)誤描述(若為回調(diào)返回,應(yīng)返回成功code200即可) | / |
msg | String | 否 | / | 錯(cuò)誤說明,當(dāng)code!=200時(shí)返回,嚴(yán)選返回錯(cuò)誤詳細(xì)信息錯(cuò)誤描述(若為回調(diào)返回,渠道自行定義錯(cuò)誤說明) | / |
subErrCode | String | 否 | / | 子錯(cuò)誤碼,當(dāng)code!=200時(shí)返回 | / |
subErrParam | Object | 否 | / | 子錯(cuò)誤參數(shù),可選,不一定有該項(xiàng),當(dāng)code!=200時(shí)返回 | / |
API響應(yīng)參數(shù)
參數(shù)名 | 參數(shù)類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
---|---|---|---|---|---|
result | List[Object] | 是 | / | SPU ID | 10018002 |
公共參數(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ù)值}”} | / |
10016 | isv.dependent-service-failed | 方法:{method}的依賴服務(wù)錯(cuò)誤,相關(guān)信息如下:{errString} | method,errString,traceId |
19999 | isp.system-error | 系統(tǒng)處理錯(cuò)誤,具體錯(cuò)誤信息(任意)待明確 | traceId |
20001 | isv.business-missing-param | 缺少參數(shù):{param} | param,traceId |
20002 | isv.business-invalid-param | 參數(shù):{param}值非法 | param,traceId |
20003 | isv.business-param-json-error | 參數(shù):{param}值執(zhí)行json解析失敗 | param,traceId |
20004 | isv.business-invalid-param-detail | 參數(shù):{param}值非法。原因:{detail} | param,detail,traceId |
20005 | isv.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×tamp=2018-12-24 16:33:38&sign=60F05EE66CB7AF757C96CD6DD8CB5508'
響應(yīng)示例
{
"code": 200,
"msg": "",
"result": [
0
]
}
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ò)。
提供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)商品信息接口
本文全面且細(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è)在激烈的市場競爭中脫穎而出。
最適合小型企業(yè)的SEO API,專家解答
Grok 2 和 Grok 3 使用教程:教你如何獲得Grok3的訪問權(quán)限
AI大模型榜單TOP10排名與詳情解析
快速提醒:用電子郵件發(fā)送短信獲取航天信息電子發(fā)票接口
API接口安全性設(shè)計(jì),項(xiàng)目中該如何保證API接口安全?
引爆排名秘訣!AI+SEO API助力網(wǎng)站優(yōu)化
免費(fèi)測試Kimi,無需api key(秘鑰)
如何獲取Microsoft API Key 密鑰實(shí)現(xiàn)bing搜索分步指南
PyJWT:輕松搞定Token認(rèn)證,讓你的API更安全!