API 예외 문제 해결 방법
1. 빠른 문제 해결
1. 빠른 문제 해결 흐름도
첨부: API 문서 주소: //open.taobao.com/api/api_list.htm? a219a.7386781.0.0.g5ZY6Y
규칙 센터 주소: //open.taobao.com/doc/detail.htm?id=101612
타오바오 고객 서비스 연락처: 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
FAQ 주소: //open.taobao.com/doc/detail.htm?id=101783
지원 센터 주소: //open .taobao.com/support/index.htm?spm=a219a.7386781.0.0.r8QQcW
긴급 질문 그룹: 228708748
플로우 차트의 문제에 대한 자세한 설명
비API 문제
타오바오 비즈니스 문제, 비즈니스 문제, 컨테이너 오류 등 개발자가 타오바오 데이터에 대한 HTTP 요청을 보내기 전에 발생하는 문제입니다.
1. 타오바오 비즈니스 문제:
(1) 비즈니스 규칙 문제: 제품 또는 사용자가 처벌받는 등
(2) 타오바오 페이지에서 실패한 운영 문제: 판매 중인 제품을 볼 수 없음 Taobao 백엔드에서 잠깐
2. 비즈니스 문제:
(1) 애플리케이션 액세스 문제: 개발자가 등록할 수 있는 애플리케이션 수 등
(2) 애플리케이션 검토 문제: 어떤 애플리케이션이 등록되지 않습니까?
( 3) 애플리케이션 실행 문제(예: 호출 빈도 제한 방법 등)
3. 컨테이너 오류 문제:
컨테이너를 통해 사용자는 개발자에게 데이터 정보를 얻을 수 있는 권한을 부여할 수 있습니다. 주로 페이지의 오류 코드가 100에서 200 사이에 있는 경우입니다.
API 문제
HTTP 연결 오류, 플랫폼 수준 오류, 비즈니스 수준 오류 등 개발자가 Taobao 데이터에 대한 HTTP 요청을 보낸 후 발생하는 문제 이 세 가지 유형의 오류 문제는 Taobao 서버에 액세스할 때 발생합니다. 이는 TOP 액세스 플랫폼과 Taobao 백엔드 비즈니스 서버의 세 가지 수준에서 발생합니다.
1. HTTP 연결 오류 문제:
Taobao 서버에 요청하는 동안 발생하는 오류는 일반적으로 HTTP 응답 코드로 표시됩니다. HTTP 서버가 보낸 메시지 응답의 첫 번째 줄입니다. 다섯 가지 유형의 응답 코드가 있으며 첫 번째 숫자로 표시됩니다.
1xx: 정보, 요청 수신, 처리 계속
2xx: 성공, 작업이 성공적으로 수락되고 이해되었으며 채택되었습니다.
3xx: 리디렉션, 요청을 완료하기 위해 추가로 수행해야 하는 작업
4xx: 클라이언트 오류, 요청에 구문 오류가 포함되어 있거나 요청을 구현할 수 없음
5xx: 서버 오류, 서버가 명백히 잘못된 요청을 구현할 수 없음
TOP 서비스는 200: http 요청 성공, 404: 요청한 서비스를 찾을 수 없음, 내부 서버 오류 등 개발자에게 받은 응답코드가 404인 경우는 사용자의 네트워크에 문제가 있다는 의미이며, 개발자에게 받은 응답코드가 500인 경우에는 네트워크는 정상이나 상위 서비스가 응답할 수 없다는 의미입니다.
로컬 네트워크에 문제가 있는 경우 ping gw.api.taobao.com 명령줄을 직접 입력하여 타오바오 서버 요청 속도를 테스트할 수 있습니다. 속도가 매우 느린 경우 서버 속도를 높여보세요. ping에 실패하면 네트워크 관리자에게 문의하여 서버가 Taobao 도메인 이름을 차단하는지 확인하세요.
2. 플랫폼 수준 오류 문제:
TOP에 플랫폼 액세스를 요청하면 오류가 발생합니다. 이때 TOP에서 반환한 오류 코드는 100 미만입니다. 이 오류는 일반적으로 사용자의 요청이 권한을 준수하지 않기 때문에 발생합니다. , 보안, 트래픽 및 가장 기본적인 매개변수는 검증으로 인해 발생합니다.
3. 비즈니스 수준 오류 문제:
백엔드 비즈니스 서버에 문제를 요청합니다. 반환되는 오류 코드는 500~1000입니다. 구체적인 하위 오류 코드 및 해결 방법은 API 설명서를 참조하세요.
2. 자세한 문제 해결 흐름도
위 문제를 발견한 후 개발자의 처리 흐름을 자세히 설명합니다. 
3. 빠른 문제 해결 예시
오류 로그에서 taobao.item.recommend.add를 분석해서 isv.item-recommend-service- error를 보고했습니다. :ERROR_MORE_THAN_ALLOWED_RECOMMEND_NUM (전체 창 권장 개수 초과) 오류가 많은데 어떻게 해결하나요?
먼저 문제 해결 과정에 따라 API 문제를 찾은 후 API 문서에서 오류 코드 해결 방법을 확인하세요.
1 창을 추천할 때 창 추천 총액을 입력해야 하는 사용자도 있습니다. 더 많이 잃으므로 추천창 신고하기 오류가 최대 추천수를 초과할 경우 총 쇼케이스 수 = 추천 쇼케이스 수 + 남은 쇼케이스 수(이 오류는 완전히 해소될 수는 없습니다)가 매일 정기적으로 업데이트됩니다.
2. 개발자는 먼저 taobao.shop.remainshowcase.get 인터페이스를 호출하여 판매자의 남은 디스플레이 창 수를 논리적으로 판단한 후 창 추천 인터페이스를 호출합니다.
예 2
로컬 프로그램에서 연결 재설정 오류를 보고하고 상위 오류 코드가 반환되지 않습니다. 이런 종류의 문제를 해결하는 방법은 무엇입니까?
권장 사항:
1. 작업을 합리적으로 줄이고, 작업 세분화를 줄이고, 트랜잭션 실행 성공률을 높이고, 롤백 비용을 줄입니다.
2. 허용된 시간 간격 내에서 작업의 중복 콘텐츠를 줄입니다.
3. 단일 루프 호출 수를 줄이기 위한 일괄 작업 인터페이스가 있는지 확인합니다.
4. 작업자 스레드 풀의 스레드 수를 제어하고 그에 따라 병렬 작업 수를 설정합니다. 실제 성능과 다른 서버의 처리 용량:
동시에 개발된 스레드가 많을수록 성공률은 높지 않을 수 있습니다!
첫째, 로컬 리소스는 제한되어 있습니다(스레드를 많이 열수록 로컬 GC 재활용 빈도가 높아져 실행 속도에 영향을 미치고 효율성이 떨어집니다).
둘째, 상대방이 적극적으로 연결을 거부할 수 있습니다. 너무 많은 IP 연결로 인해 (DOS 보호)
채널을 재사용할 수 없습니다. (현재 1.6 JDK 버전에서는 TCP 채널을 더 잘 재사용할 수 있게 되었습니다. 많은 수의 TCP 채널을 동시에 여는 것 자체가 손실입니다. 때로는 부분 직렬화로 인해 생성되는 TCP 채널 수가 어느 정도 줄어들고 채널을 합리적으로 사용하는 경우도 있습니다. 효율성과 성공률을 높이려면 클라이언트가 흐름 제어를 수행하는 것도 중요합니다)
예 3
네트워크 패킷 손실 문제 해결 방법:
문제 배경:
1. 인터넷의 물리적 회선은 100%가 아니며, ISV 서버와 TOP
2 간의 통신에 데이터 손실이 있습니다. 개발자는 각 액세스에서 얻은 데이터가 완전한지, 패킷 손실이 있는지 확인할 수 있는 방법이 필요합니다
3. 현재 일부 ISV는 무결성을 확인하기 위해 이 방법을 사용합니다. API를 연속해서 여러 번 호출하고 반환된 결과가 정확히 동일하면 완료된 것으로 간주됩니다. 이 방법은 신뢰할 수 없으며(여러 번의 호출로 인해 다른 비즈니스 결과가 반환될 수 있음), ISV 개발 비용이 증가하고 TOP의 서버 부담도 증가합니다. 해결 방법:
개발자가 피드백하는 ISV 검증 데이터 문제를 해결하기 위해 TOP는 완전성을 추가했습니다. HTTP 헤더의 새 요소: top-bodylength.
사용법: 개발자는 top-bodylength 값을 가져와 수신된 HTTP Body 길이를 계산합니다. 두 값이 동일하면 계산된 HTTP Body 길이가 top-bodylength보다 작으면 반환된 데이터가 완료된 것입니다. 값은 패킷 손실이 발생했음을 나타냅니다.
참고:
1: TOP는 HTTP 본문을 변경하지 않으므로 기존 애플리케이션에 영향을 미치지 않습니다.
2: top-bodylength는 HTTP Body를 나타내는 문자열 문자의 길이입니다. (중국어, 영어 모두 1로 계산됩니다.)
2. 오류 코드 목록
1. API 호출 발생할 수 있는 오류에는 API 플랫폼 오류, ISV 비즈니스 오류, 컨테이너 오류 등 세 가지 유형이 있습니다. 다음은 ISV 성공률 관련 명사를 소개합니다.유효 방문수 = 방문 성공수 + ISV 업무 오류(방문 성공수는 정상적으로 데이터를 얻고 오류가 없는 통화를 말합니다.)
ISV 성공률 = 방문 성공/유효 방문
2. 타오바오 서버 접속 시 발생하는 오류는 주로 http 연결 오류 또는 연결 재설정 및 거부로 인해 발생합니다. 이러한 오류는 타오바오 서버에 직접 접속하거나 검색해 보세요. 온라인으로 답변합니다.
1. API 플랫폼 오류
(1) 오류 코드가 100 미만인 호출 오류(오류 코드 15, 40, 41 제외) , 이 오류는 일반적으로 사용자의 요청이 다양한 기본 점검 사항을 준수하지 않아 발생합니다. 사용자에게 이러한 오류가 발생하면 먼저 애플리케이션의 권한, 빈도 등을 확인한 다음 설명서를 참조하여 수신 매개변수가 완전하고 합법적인지 확인합니다.
(2) 하위 오류 코드(sub_code)는 "isp."로 시작하는 호출 오류입니다. 이 오류는 일반적으로 서버 측 예외로 인해 발생합니다. 이러한 유형의 오류가 발생한 사용자는 문제를 해결하기 위해 일정 시간 후에 다시 시도해야 합니다.
오류 코드가 100보다 작은 플랫폼 수준 오류
| 오류코드 오류설명-영어오류설명-중국어 해결방법 3업로드 실패 이미지 업로드에 실패했습니다. 수신되는 이미지 형식을 올바른 형식과 적절한 크기의 이미지로 메시지 본문에 변경하고 전송에 실패할 경우. , 사진 크기를 줄이거나 네트워크 대역폭을 늘리고 7App Call Limited를 시도해야 합니다. 제한 조정 프로그램을 초과하는 호출 빈도를 포함하여 응용 프로그램 호출 수가 제한을 초과합니다. API를 호출하고 빈도 제한 시간이 될 때까지 기다리십시오. Taoke의 통화 빈도는 위 사항에 따라 시스템의 월별 거래량이 자동으로 수정되며, 수정된 빈도는 공식 포럼 홈페이지에서 공지 형식으로 공지됩니다. 개발자가 직접 확인할 수 있습니다. 허용되지 않음HTTP 방식은 금지됩니다. 대문자 POST 또는 GET을 사용하십시오. 전달된 사진 및 기타 정보가 있는 경우 POST를 사용해야 합니다. 10현재 서비스를 사용할 수 없습니다. 서비스를 사용할 수 없는 경우는 대부분 알 수 없는 예외로 인해 전달됩니다. 11ISV 권한이 부족합니다. 현재 isv.permission-api-package가 비어 있는 하위 오류 코드는 비즈니스 규칙에 따라 해당 권한을 신청하는 것이 좋습니다. isv.permission-api-package-not-allowed는 접근 불가능한 그룹의 API에 대한 접근을 허용하지 않습니다. 실제로 필요한 경우 접근 불가능한 그룹의 API에 접근하기 위해 신청한 애플리케이션 라벨이 올바른지 확인하는 것이 좋습니다. 그룹의 경우 비즈니스 규칙에 따라 해당 비즈니스 라인에서 권한을 신청해야 합니다. 예: 구매자 액세스 불가 그룹에는 구매자 애플리케이션이 isv.permission-api-package에 액세스하는 것을 허용하지 않는 일부 주문 API가 있습니다. -limit.관련 패키지는 API에 대한 접근을 허용하지 않으며, 비즈니스 규칙에 따라 isv.permission-ip-whitelist-limit를 적용하는 것이 좋습니다. 보안 센터에서 올바른 IP 화이트리스트 isv.permission-api-widget-only-limit를 구성하세요. 위젯(구성 요소) 액세스만 허용하세요. 12사용자 권한이 충분하지 않습니다.애플리케이션에 부가 가치 권한의 인터페이스를 호출할 수 있는 권한이 없습니다. 타오바오 파트너 백엔드에서 권한 신청서를 제출할 수 있습니다.13파트너 권한 부족파트너 권한 부족애플리케이션에 부가 가치 권한 인터페이스를 호출할 수 있는 권한이 없습니다. 타오바오 파트너 백그라운드에서 제출할 수 있습니다. 권한 신청서 제출 21메서드 누락 메소드 이름 매개변수가 누락되었습니다. 메소드 필드에 추가되었습니다. 22잘못된 메소드 메소드 이름이 존재하지 않습니다. 수신 메소드 필드는 호출 중인 API의 이름이어야 하며, API가 실제로 존재해야 합니다. 23잘못된 형식 잘못된 데이터 형식이 전달된 형식은 json 또는 중 하나여야 합니다. 24Missing Signature에는 서명 매개변수가 없습니다. 25Invalid Signature는 올바른 알고리즘에 따라 계산되어야 합니다.알고리즘은 다음을 참조하세요. //open.taobao.com/doc/detail.htm?id=101617#ss226Missing SessionKey 매개변수가 누락되었습니다. 전달된 매개변수에는 27Invalid Session, unmix-sessionkey가 포함되어야 합니다. -failure 잘못된 SessionKey 매개 변수가 전달되었습니다. 세션을 바인딩하는 사용자가 세션을 얻어야 합니다. 보고된 세션이 불법인 경우 사용자가 세션을 바인딩하지 않았거나 세션이 만료되었기 때문일 수 있습니다. 새 sessionKey를 전달합니다.28Missing 앱 키에 전달된 AppKey 매개변수가 없습니다. 매개변수에는 app_key 필드가 포함되어야 합니다. 29잘못된 앱 키 잘못된 AppKey 매개변수 애플리케이션이 위치한 환경이 선택한 환경과 일치하지 않습니다. 샌드박스 테스트 환경이지만 공식 환경에서 테스트하기로 선택했습니다. 30Missing Timestamp 타임스탬프 매개변수가 누락되었습니다. 31잘못된 타임스탬프는 잘못된 타임스탬프 매개변수입니다. 형식은 yyyy-mm-dd hh:mm:ss입니다. 23:30 . Taobao API 서버에서는 클라이언트가 10분의 시간 오류를 요청할 수 있습니다. 32 누락된 버전에 버전 매개변수가 누락되었습니다. 33 잘못된 버전 매개변수가 포함되어 있어야 합니다. 형식이 올바르지 않으며 숫자 형식이어야 합니다. 34 지원되지 않는 버전입니다. 사용자가 전달한 버전 번호가 제공되지 않았습니다. 42부족한 세션 권한이 부족합니다. 고위험 API가 호출됩니다. 보안 수준 문서 //open.taobao.com/doc/detail.htm?id=100243 매개변수 오류입니다. 일반적으로 사용자가 전달한 잘못된 매개변수로 인해 발생합니다. 입력 매개변수의 형식과 범위가 일치하는지 주의 깊게 확인하세요. 44잘못된 액세스 토큰은 일반적으로 사용자가 상위 프로토콜을 사용하여 얻은 세션 키로 API를 호출하거나 https를 통해 환경을 호출하는 데 사용됩니다. 47잘못된 인코딩 인코딩 오류는 일반적으로 발생합니다. http 요청 시 사용자가 UTF-8 인코딩을 사용하지 않아서 발생합니다. |
2. ISV 비즈니스 오류
1 ISV에서 전달한 매개 변수가 누락되었거나 잘못되었거나 형식이 지정되어 발생하는 오류입니다. 따라서 isv는 오류 메시지를 기반으로 해당 정보가 전달되었는지 확인해야 합니다. 이러한 유형의 오류는 수정하고 다시 시도하는 것이 좋습니다.
주로 다음 두 가지 범주가 포함됩니다.
(1) 오류 코드 40 및 41의 오류는 주로 필수 매개변수가 전달되지 않은 경우의 오류이고, 41은 주로 매개변수 형식의 오류입니다. 전달된 내용이 올바르지 않습니다. :2.
(2) 오류 코드가 100보다 크거나 15와 같고 하위 오류 코드(sub_code)가 "isv"로 시작합니다.【( error code> 100 or error code = 15 ) 및 (isv로 시작)] 호출 오류:
2. 오류 응답은 isv가 최상위 서비스를 호출할 때 호출이 실패할 경우 발생하는 가장 직접적인 징후입니다. 나중에 오류를 추적할 수 있도록 오류 로그를 보관해 두십시오.
3, 40/41 오류 소개
| 오류 코드 오류 설명 - 영어 오류 설명 - 중국어 솔루션 40Missing 필수 인수가 API 문서에서 필수로 설정된 필수 매개변수가 누락되었습니다. 선택한 매개변수를 전달해야 합니다. 문서를 주의 깊게 확인하십시오. 41잘못된 인수 잘못된 매개변수 매개변수 유형이 잘못되었습니다. 예: 숫자 유형을 전달해야 하는데 문자 유형 매개변수가 전달됩니다. |
4 . 비즈니스 수준 하위 오류
| 하위 오류 코드 형식 오류 메시지 소유자는 isv.###-존재하지 않음: ***Cannot query before *** ###ISV에서 다시 시도할 수 있습니다. isv.missing-parameter 없음: ***필요한 매개변수 누락***ISV 아니요 isv.invalid-paramete:***매개변수***가 유효하지 않음, 잘못된 형식, 잘못된 값, 범위를 벗어남 등. ISVNo isv.invalid -permission이 충분하지 않습니다. ISV에 대한 불법 액세스입니다. isv.parameters-mismatch:***-and-###수신 매개변수 *** 및 ###이 일치하지 않으며 둘 사이에는 일정한 대응 관계가 있습니다. ISV 아니요 isv.***-service -error: ### *** 서비스 호출 시 false, 비즈니스 논리 오류가 반환됩니다. ###은 특정 오류 메시지를 나타냅니다. ISV 아니요 |
3. 보안 수준 및 보안 취약점 오류 코드
부모 오류 코드 정보
오류 코드 | 영어 설명 | 중국어 설명 | Solution |
53 | 불충분한 보안 수준 | 보안 수준이 부족함 | 애플리케이션 보안 수준을 개선하거나 인증 보안 수준을 새로 고치세요 |
하위 오류 코드 정보
하위 오류 코드 정보 | 텍스트 설명 | 어트리뷰션 파티 | 솔루션 |
고위험 보안 침해 |
| ISV 보안 취약점 해결 후 재출시 | |
중위험 보안 침해 | 중위험 보안 취약점이 있습니다 | ISV | 보안 취약점 수정 후 다시 출시 |
R1 보안 승인 누락 | R1 레벨 인증 없음 | ||
R1 보안 인증이 유효하지 않음 | R1 레벨 인증이 만료되었습니다 | ISV | R1 수준 인증(사용자 재인증 또는 새로고침 인증)의 경우 |
R2 보안 인증 누락 | R2 수준에서 승인되지 않음 | ISV | R2 수준 인증(사용자 재인증 또는 새로고침 인증) |
R2 보안 인증이 유효하지 않음 | R2 수준 승인이 만료됨 | ISV | R2 수준 승인 수행(사용자가 승인을 다시 승인하거나 새로 고침) |
W1 보안 승인 누락 | W1 레벨 인증 아님 | ISV | W1 수준 인증(사용자 재인증 또는 새로고침 인증) |
W1 보안 인증이 유효하지 않음 | W1 수준 승인이 만료됨 | ISV | W1 수준 승인 수행(사용자가 승인을 다시 승인하거나 새로 고침) |
W2 보안 승인이 유효하지 않음 | W2 레벨 승인되지 않음 | ISV | W2 수준 인증(사용자 재인증 또는 새로고침 인증)의 경우 |
W2 보안 인증이 유효하지 않음 | W2 수준 승인이 만료됨 | ISV | W2 수준 승인 수행(사용자가 승인을 다시 승인하거나 새로 고침) |
4. 기타 고유 오류 코드
FAQ
- 아직 이 문서에 대한 FAQ가 없습니다
