Troubleshooting and Error Codes

更新时间：2015/09/18 访问次数：20642

List of error codes
API Platform Errors
ISV Business Errors
Security Level and Security Breach Error Codes
Other Specific Error Codes

List of error codes

1. When a developer calls API, three categories of errors may occur: API platform errors, ISV business errors and container errors. The following describes the terms related to the ISV success rate:

Valid page view = Successful page view + ISV business error (a successful page view refers to a call in which the data is obtained successfully and no error is reported)

ISV success rate = Successful page view/Valid page view

2. The errors from connecting Taobao server mainly involve http connection errors or connections reset or rejected, etc. They occur when a developer gains access to Taobao server. Contact a server administrator or use the Internet to search for solutions.

API Platform Errors

API platform errors mainly fall into two categories:

1. Call errors with an error code being less than 100 (excluding error codes 15, 40, 41): These errors usually occur, because the request from a user does not fulfill the basic verification. When encountering such errors, check the authority, frequency and other conditions of the applications. Then, check the uploaded parameters for completeness and validity based on the document.

2. Call errors with a sub-error code (sub_code) starting with “isp.”: These errors usually occur, because the server operates abnormally. When encountering such errors, try again some time later.

Platform errors with an error code being less than 100

Error code	English	Description	Solution
3	Upload Fail	Fail to upload pictures.	Change the format of images to be uploaded into correct format and proper size, and then put them into the message body to upload. If uploading still fails, zoom out the image or increase the network bandwidth to try again.
7	App Call Limited	Application calls (including frequency calls) exceed the maximum times.	Adjust the program, and call the API properly after the time limited for frequency. The call frequency of Taobao is changed automatically by the system according to the trading volume in the last month. The updated frequency is announced on the home page of the official forum and can be viewed by the developer.
9	Http Action Not Allowed	HTTP actions are not allowed.	Use POST or GET in uppercase. If any information (such as an image) needs to be uploaded, always use POST.
10	Service Currently Unavailable	The service is unavailable.	The error usually occurs because of unknown anomaly. Carefully check the uploaded parameters for compliance with the description in the document.
11	Insufficient ISV Permissions	The ISV has insufficient authority.	Current sub error codes are as follows: isv.permission-api-package-empty: No access package is involved. It is recommended to apply for the corresponding authority based on business rules. isv.permission-api-package-not-allowed: It is not allowed to access the API in an inaccessible group. It is recommended to check the applied application tags for correctness. To access the API in an inaccessible group, apply for the authority at the corresponding business line based on business rules. For example, the inaccessible group of a buyer contains some order APIs that cannot be accessed by the application of the buyer. isv.permission-api-package-limit: The package involved is not allowed to access this API. It is recommended to apply for the corresponding authority based on business rules. isv.permission-ip-whitelist-limit IP; The access is limited and is not allowed. It is recommended to configure a correct white list for IP addresses in the security center. isv.permission-api-widget-only-limit; The access is allowed only in widget (assembly) mode.
12	Insufficient User Permissions	The user has insufficient authority.	The application is not permitted to call the interface for value-added authority. An application for permission can be submitted at the background of Taobao partner.
13	Insufficient Partner Permissions	The partner has insufficient authority.	The application is not permitted to call the interface for value-added authority. An application for permission can be submitted at the background of Taobao partner.
21	Missing Method	The method name parameter is missing.	Add the method field to uploaded parameters.
22	Invalid Method	The method name does not exist.	The uploaded method field must be the called API name, and the API already exists.
23	Invalid Format	Invalid data format.	The uploaded format must be json or xml.
24	Missing Signature	The signature parameter is missing.	The uploaded parameters must contain the sign field.
25	Invalid Signature	Invalid signature.	Signature must be calculated based on the correct algorithm. For the algorithm, visit the website:click
26	Missing Session	The SessionKey parameter is missing.	The uploaded parameters must contain the session field.
27	Invalid Session, unmix-sessionkey-failure	Invalid SessionKey parameter.	The uploaded session must be obtained from the session bound by a user. When not being bound by the user or being out of date, the session may be reported to be invalid. The user needs to rebind and upload the new sessionKey.
28	Missing App Key	The AppKey parameter is missing.	The uploaded parameters must contain the app_key field.
29	Invalid App Key	Invalid AppKey parameter.	The environment of the application is different from the selected one. For example, the application is in the sandbox test environment, but is tested in the formal environment.
30	Missing Timestamp	The timestamp parameter is missing.	The uploaded parameters must contain the timestamp field.
31	Invalid Timestamp	Invalid timestamp parameter.	Timestamp, in the format of yyyy-MM-dd HH:mm:ss, e.g. 2008-01-25 20:23:30. Taobao API server allows the request time error on a client to be maximally 10 minutes.
32	Missing Version	The version parameter is missing.	The uploaded parameters must contain the v field.
33	Invalid Version	Invalid version parameter.	The version number uploaded by the user is in an incorrect format. The version number must be in numerals.
34	Unsupported Version	The version No. is unsupported.	The version number uploaded by the user is unavailable.
42	Insufficient session permissions	Insufficient session authority.	The high-risk API is called. See the security level document. //open.taobao.com/doc/detail.htm?id=1002
43	Parameter Error	Parameter error.	The error usually occurs, because the parameters uploaded by the user are invalid. Carefully check the format and range of the uploaded parameters for corresponding one to one.
44	Invalid access token	Invalid access token.	The error usually occurs, because the sessionkey obtained in the top protocol by the user is taken as the access token to call the API in https mode, or because the call environment is incorrect.
47	Invalid encoding	Encoding error.	The error usually occurs, because the user does not use the UTF-8 format to encode the http request.

Platform sub errors

Format of sub error codes	Error information	Owner	Whether the retry operation can be performed in the program
isp.***-service-unavailable	An anomaly occurred when calling the rear-end service ***, because the service is unavailable.	ISP	Yes
isp.remote-service-error	An error occurred when connecting a remote service.	ISP	Yes
isp.remote-service-timeout	Connecting a remote service times out.	ISP	Yes
isp.remote-connection-error	Remote connection error.	ISP	Yes
isp.null-pointer-exception	An exception occurred in the null pointer.	ISP	No
isp.top-parse-error	An error occurred when parsing an API (some unclearly controlled anomalies are found).	ISP	No
isp.top-remote-connection-timeout	Connecting of the top platform to the rear-end service times out.	ISP	Yes
isp.top-remote-connection-error	An error occurred when connecting the top platform to the rear-end service, and the service failed to be found.	ISP	Yes
isp.top-mapping-parse-error	An error occurred when parsing top-mapping due to incorrect format of the uploaded parameters.	ISP	No
isp.unknown-error	Unknown anomalies are displayed when the top platform connects to the rear-end service.	ISP	Yes

ISV Business Errors

1. ISV business errors result from missing or incorrect parameters uploaded by ISV, or from incorrect formats of these parameters, etc. For this reason, the ISV shall check whether the corresponding information is uploaded based on the error information. It is recommended to try again after correcting such errors.

Two categories are involved mainly:

(1) Errors with error codes 40 and 41: The error code 40 means mandatory parameters are not uploaded, and the error code 41 means parameters uploaded are in incorrect format.

(2) Call errors with an error code being greater than 100 or equal to 15 and a sub error code (sub_code) starting with “isv” [(error code > 100 or error code = 15) and (starting with isv)]:

2. An error response directly presents the failed interaction between the user and the server. When the ISV fails to call the top service, keep the error log for future retrieval if possible.

3. Errors with error codes 40 and 41

Error code	English	Description	Solution
40	Missing Required Arguments	Mandatory parameters are missing.	The parameters set as “Mandatory” in the API document must be uploaded. Carefully check the document for these parameters.
41	Invalid Arguments	Invalid parameters.	The parameter category is incorrect. For example, the required parameter needs to be in numerals, but the uploaded parameter is in characters.

4. Business sub errors

Format of sub error code	Error information	Owner	Whether the retry operation can be performed in the program
isv.###-not-exist:***	### fails to be found according to ***.	ISV	No
isv.missing-parameter:***	Necessary parameter *** is missing.	ISV	No
isv.invalid-paramete:***	The parameter *** is invalid because of incorrect format, invalid value, or crossing the border.	ISV	No
isv.invalid-permission	Limited permission, invalid access.	ISV	No
isv.parameters-mismatch:***-and-###	The uploaded parameters do not match ###, and they are in certain corresponding relation.	ISV	No
isv.***-service-error:###	False is returned when calling the *** service because of business logic error. ### refers to specific error information.	ISV	No

Security Level and Security Breach Error Codes

Information about parent error codes

Error code	English	Description	Solution
53	Insufficient security level	Insufficient security level.	Improve the application security level, or refresh the authorization security level.

Information about sub error codes

Sub error code	Description	Owner	Solution
high-risk security breach	The high-risk security breach exists.	ISV	Re-publish after solving the security breach.
mid-risk security breach	The mid-risk security breach exists.	ISV	Re-publish after solving the security breach.
R1 security authorize missing	The R1-level authorization is not provided.	ISV	Provide the R1-level authorization (the user is authorized again, or the authorization is refreshed).
R1 security authorize invalid	The R1-level authorization is invalid.	ISV	Provide the R1-level authorization (the user is authorized again, or the authorization is refreshed).
R2 security authorize missing	The R2-level authorization is not provided.	ISV	Provide the R2-level authorization (the user is authorized again, or the authorization is refreshed).
R2 security authorize invalid	The R2-level authorization is invalid.	ISV	Provide the R2-level authorization (the user is authorized again, or the authorization is refreshed).
W1 security authorize missing	The W1-level authorization is not provided.	ISV	Provide the W1-level authorization (the user is authorized again, or the authorization is refreshed).
W1 security authorize invalid	The W1-level authorization is invalid.	ISV	Provide the W1-level authorization (the user is authorized again, or the authorization is refreshed).
W2 security authorize invalid	The W2-level authorization is not provided.	ISV	Provide the W2-level authorization (the user is authorized again, or the authorization is refreshed).
W2 security authorize invalid	The W2-level authorization is invalid.	ISV	Provide the W2-level authorization (the user is authorized again, or the authorization is refreshed).

Other Specific Error Codes

801	Parameter errors of App requests. They usually occur, because necessary parameters are missing.
802	Signature error. It may occur when the agreement is required to be signed.
803	Invalid timestamp. The difference between the time shown by the timestamp and that on the server can not exceed 5 minutes.

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

国际化类目

Troubleshooting and Error Codes

List of error codes

Valid page view = Successful page view + ISV business error (a successful page view refers to a call in which the data is obtained successfully and no error is reported)

ISV success rate = Successful page view/Valid page view

API Platform Errors

ISV Business Errors

(1) Errors with error codes 40 and 41: The error code 40 means mandatory parameters are not uploaded, and the error code 41 means parameters uploaded are in incorrect format.

(2) Call errors with an error code being greater than 100 or equal to 15 and a sub error code (sub_code) starting with “isv” [(error code > 100 or error code = 15) and (starting with isv)]:

Security Level and Security Breach Error Codes

Other Specific Error Codes

FAQ