오류

업데이트 됨 1 주일 이상 전에

API는 모든 작업에 대한 표준 HTTP 성공 또는 오류 상태 코드를 반환합니다. 오류의 경우 응답에는 해당 오류 코드, 오류의 원인을 설명하는 짧은 메시지 및 선택적으로 해당 오류와 관련된 정보를 전달하는 추가 필드가 포함됩니다.

상태 코드

code	name	description
200	OK	The request was processed succesfully.
201	Created	The request was processed successfully, and a new resource instance was created.
400	Bad Request	The API was unable to process the request as it was malformed in some way.
401	Unauthorized	The API was unable to find valid credentials in the request.
403	Forbidden	The credentials provided do not have sufficient permissions to perform the request.
404	Not Found	The requested resources cannot be found.
429	Too Many Requests	The request has not been processed as a rate limit has been reached.
5xx	Internal Server Error	An unexpected error occurred while processing the event.

API가 요청 본문을 처리하지 못했습니다. 요청 본문이 유효한 JSON인지 확인하십시오.

요청 본문에있는 하나 이상의 매개 변수가 유효성 검사를 통과하지 못했습니다. 이 응답에는 문제가되는 매개 변수에 대한 세부 정보가 포함 된 params 특성이 포함됩니다.

조직에서 API가이 요청을 완료하는 데 필요한 구성을 가지고 있지 않습니다. 메시지에는 누락 된 구성에 대한 세부 정보가 포함됩니다.

조직, 키 또는 현재 사용자에게이 요청을 수행하는 데 필요한 권한 범위가 없습니다.

조직, 키 또는 현재 사용자에게 부과 된 한도를 위반하여 요청을 완료 할 수 없습니다. 예를 들어, 한 달에 두 개의 iCloud 계정에 액세스 할 수있는 사용자는 세 번째 계정에 액세스하려고하면이 오류가 발생합니다.

이 요청에 사용하려는 세션이 API에 의해 만료 된 것으로 표시되었습니다. 계속 진행하기 전에 새 유효한 세션을 만들어야합니다.

제공된 자격 증명은 외부 서비스에 의해 거부되었습니다. 소스가 존재하지 않습니다 (즉, 유효하지 않은 사용자 이름) 또는 자격 증명 페이로드가 틀립니다 (예 : 잘못된 암호).

소스는 외부 서비스에 의해 잠겨져 있으며 사용자가 잠금을 해제 할 때까지 API에서 액세스 할 수 없습니다. API 메시지는 관련 서비스에 대해이 작업을 수행하는 방법에 대한 지침을 제공합니다.

세션을 만들려고하는 원본에 MFA (Multi-Factor Authentication)가 활성화되어 있습니다. API가 MFA 프로세스를 트리거 했으므로 다음 세션 생성시이 프로세스 중에 제공된 코드를 제공해야합니다.

세션 생성 흐름에 대한 자세한 내용은 액세스하려는 서비스의 서비스 참조를 참조하십시오.

사용자가 유효하지 않은 코드를 사용하여 세션을 만들려고했으며 서비스에 의해 속도가 제한되었습니다. 재 시도하기 전에 적어도 한 시간을 기다리는 것이 좋습니다.

액세스하려는 소스에 다중 인증 (MFA)의 하위 세트 인 2 단계 인증 (2SV)이 활성화되어 있습니다. 이 응답의 일부로 API는 2SV 프로세스를 트리거 할 수있는 장치 목록을 제공합니다. 이 장치는 프로세스의 다음 단계에 필요할 2SV 코드를 수신합니다.

세션 생성 흐름에 대한 자세한 내용은 액세스하려는 서비스의 서비스 참조를 참조하십시오.

일반 작업 오류가 발생했습니다. 폴링 또는 작업을 다시 시도하면 문제가 해결 될 수 있습니다. 문제가 지속되면 지원 센터에 문의하십시오.

사용자가 최신 iCloud 서비스 약관에 동의하지 않았습니다. 계정을 사용하여 iOS 또는 macOS 장치에서 App Store에 로그인하거나 iCloud.com 으로 이동하여 약관에 동의 할 수 있습니다.

iCloud 계정과 연관된 기본 이메일 주소는 아직 확인되지 않았습니다. 계정을 활성화하려면 이메일 확인 프로세스를 완료해야합니다. appleid.apple.com 에 로그인하여 확인 프로세스를 관리 할 수 있습니다.

작업을 완료하는 데 필요한 iCloud 서비스가 사용중인 iCloud 계정에서 활성화되지 않았습니다. 예를 들어, 사용자가 계정에서 iCloud 사진 icpl.photos 활성화하지 않은 경우 icpl.photos 를 검색하려고하면이 오류가 발생합니다.

사용자가 서비스의 관련 설정을 전환하여 활성화되었는지 확인하십시오.

iCloud 중단으로 인해 작업을 완료 할 수 없습니다. 이는 매우 드물고 일반적으로 일시적이므로 몇 분 내에 다시 시도하면 성공합니다. 그러나 문제가 지속되면 iCloud 상태 페이지 및 API 상태 페이지 에서 자세한 정보를 찾아 지원 센터에 문의 하십시오 .

지원 팀이 도와 드리겠습니다!

근무 시간은 월요일부터 금요일, 오전 9 시부 터 오후 5시 (그리니치 표준시)입니다. 시간은 현재 3:50 오전 GMT입니다.

우리는 1 일 이내에 모든 메시지에 답장하고자합니다.