附：API文檔地址：//open.taobao.com/api/api_list.htm?spm=a219a.7386781.0.0.g5ZY6Y

規(guī)則中心地址：//open.taobao.com/doc/detail.htm?id=101612

淘寶客服聯(lián)系方式：http://www.taobao.com/about/contact.php

API測試工具地址：http://my.open.taobao.com/apitools/apiTools.htm

錯誤碼一覽地址：//open.taobao.com/doc/detail.htm?id=101645

論壇地址：//open.taobao.com/bbs/forum.php

常見技術(shù)問題地址：//open.taobao.com/doc/detail.htm?id=101783

支持中心地址：//open.taobao.com/support/index.htm?spm=a219a.7386781.0.0.r8QQcW

緊急問題旺旺群：228708748

我從錯誤日志中分析出來taobao.item.recommend.add報isv.item-recommend-service- error:ERROR_MORE_THAN_ALLOWED_RECOMMEND_NUM（超過櫥窗推薦總數(shù)）錯誤很多，該如何解決呢？

首先根據(jù)排查問題流程定位到API問題，再查看API文檔中的錯誤碼解決方案：

1. 櫥窗推薦的時候要求用戶輸入櫥窗推薦總量，有的用戶會多輸，所以報櫥窗推薦超過最大推薦數(shù)的錯誤，每天定時更新櫥窗總量，櫥窗總量=已推薦櫥窗+剩余櫥窗（不能完全杜絕這個錯誤）

2. 開發(fā)者先調(diào)用taobao.shop.remainshowcase.get 接口獲取賣家的剩余櫥窗數(shù)，做好邏輯判斷，再調(diào)用櫥窗推薦的接口。

范例2

本地程序報連接重置錯誤且沒有top的錯誤碼返回，這類問題該如何解決？

建議：

1.合理切割任務，將任務粒度放小，減小事務時間，提高事務執(zhí)行成功率，降低回滾代價;

2.合并任務中重復的內(nèi)容，在時間間隔容許的范圍內(nèi)，減少可能重復的操作;

3.看是否有批量操作接口，減少單個循環(huán)調(diào)用次數(shù);

4.控制工作線程池線程個數(shù)，根據(jù)實際性能和對方服務器處理能力設置并行任務個數(shù)：

線程并發(fā)開的越多未必成功率越高！

首先本地資源有限（開的越多線程，本地GC回收頻率越高，影響執(zhí)行速度，效率反而降低）；

其次，對方可能會由于你的ip連接數(shù)過多主動拒絕連接；（DOS保護）

再次，信道無法復用。（當前1.6JDK版本已經(jīng)能夠較好的復用TCP信道，并發(fā)瞬間開大量的TCP信道本身就是一種損耗，有時候部分串行化，某種程度上會減少產(chǎn)生TCP信道的數(shù)目合理利用信道，提高效率和成功率，客戶端做好流控也很重要）

范例3

網(wǎng)絡丟包問題解決方案：

問題背景：

1.由于互聯(lián)網(wǎng)物理線路可靠性不是100%，ISV服務器到TOP之間的通信存在數(shù)據(jù)丟失情況

2.開發(fā)者需要一種方法來驗證每次訪問取得的數(shù)據(jù)是不是完整的，有沒有丟包

3.目前有的ISV通過這樣的方法校驗完整性：連續(xù)多次調(diào)用API，并比較返回結(jié)果，若完全相同，則認為是完整的。這種方法不可靠（多次調(diào)用本來就有可能返回不同的業(yè)務結(jié)果），增加了ISV開發(fā)成本，也加重了TOP的服務器壓力

解決方案：

為了解決開發(fā)者反饋的ISV校驗數(shù)據(jù)完整性的問題，TOP已經(jīng)在HTTP Header中加入一個新的元素：top-bodylength。

使用方法：開發(fā)者取到這個top-bodylength的值，計算一下收到的HTTP Body長度，如果兩者相等，則說明返回的數(shù)據(jù)是完整的，如果計算出來HTTP Body的長度小于top-bodylength的值，說明發(fā)生了丟包。

注：

1：TOP沒有改HTTP Body，所以，不會對已有應用造成任何影響。

2：top-bodylength是表示HTTP Body的個String字符長度（不區(qū)分中文英文，都算作1個長度）

二、錯誤碼一覽表

1.目前開發(fā)者調(diào)用API可能出現(xiàn)的錯誤有三類：API平臺錯誤、ISV業(yè)務錯誤和容器類錯誤。下面介紹一下和ISV成功率有關(guān)的名詞說明：

有效訪問量=成功訪問量+ISV業(yè)務錯誤 （成功訪問指的是正常獲取到數(shù)據(jù)并且無報錯的調(diào)用）

ISV成功率=成功訪問量/有效訪問量

2.連接淘寶服務器錯誤主要是http連接錯誤或者連接被重置被拒絕等，這類錯誤是開發(fā)者訪問淘寶服務器出現(xiàn)的問題，請直接聯(lián)系服務器管理員或通過網(wǎng)絡搜索答案。

1、API平臺錯誤

2、ISV業(yè)務錯誤

1.ISV業(yè)務級錯誤是ISV傳入的參數(shù)缺失，有誤或格式錯誤等原因造成的錯誤。因此isv應該根據(jù)錯誤信息檢驗是否傳入了相應的信息，對于這一類錯誤建議改正后再重試。

3、安全等級和安全漏洞錯誤碼

父錯誤碼信息

 

錯誤碼	英文描述	中文描述	解決方案
53	Insufficient security level	安全等級不足	提高應用安全等級或刷新授權(quán)安全等級

 

子錯誤碼信息 

 

子錯誤碼信息	中文描述	歸屬方	解決方案
high-risk security breach	存在高危安全漏洞	ISV	解決安全漏洞后重新發(fā)布
mid-risk security breach	存在中級安全漏洞	ISV	解決安全漏洞后重新發(fā)布
R1 security authorize missing	未進行R1級別授權(quán)	ISV	進行R1級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
R1 security authorize invalid	R1級別授權(quán)過期	ISV	進行R1級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
R2 security authorize missing	未進行R2級別授權(quán)	ISV	進行R2級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
R2 security authorize invalid	R2級別授權(quán)過期	ISV	進行R2級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
W1 security authorize missing	未進行W1級別授權(quán)	ISV	進行W1級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
W1 security authorize invalid	W1級別授權(quán)過期	ISV	進行W1級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
W2 security authorize invalid	未進行W2級別授權(quán)	ISV	進行W2級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）
W2 security authorize invalid	W2級別授權(quán)過期	ISV	進行W2級別授權(quán)（用戶重新授權(quán)或刷新授權(quán)）

4、其它特有錯誤碼