오류
API는 모든 작업에 대한 표준 HTTP 성공 또는 오류 상태 코드를 반환합니다. 오류의 경우 응답에는 해당 오류 코드, 오류의 원인을 설명하는 짧은 메시지 및 선택적으로 해당 오류와 관련된 정보를 전달하는 추가 필드가 포함됩니다.
상태 코드
| 암호 | 이름 | 설명 |
|---|---|---|
| 200 | 좋아요 | 요청이 성공적으로 처리되었습니다. |
| 201 | 생성됨 | 요청이 성공적으로 처리되었으며, 새로운 리소스 인스턴스가 생성되었습니다. |
| 400 | 잘못된 요청 | API는 어떤 방식으로든 잘못된 형식으로 요청을 처리할 수 없습니다. |
| 401 | 무단 | API가 요청에서 유효한 자격 증명을 찾을 수 없습니다. |
| 403 | 금지됨 | 제공된 자격 증명에는 요청을 수행할 수 있는 충분한 권한이 없습니다. |
| 404 | 찾을 수 없음 | 요청한 리소스를 찾을 수 없습니다. |
| 429 | 요청이 너무 많습니다 | 속도 제한에 도달하여 요청이 처리되지 않았습니다. |
| 5xx | 내부 서버 오류 | 이벤트를 처리하는 동안 예기치 않은 오류가 발생했습니다. |
오류 코드
invalid-body
API가 요청 본문을 처리하지 못했습니다. 요청 본문이 유효한 JSON인지 확인하십시오.
invalid-parameter
요청 본문에있는 하나 이상의 매개 변수가 유효성 검사를 통과하지 못했습니다. 이 응답에는 문제가되는 매개 변수에 대한 세부 정보가 포함 된 params 특성이 포함됩니다.
unconfigured
조직에서 API가이 요청을 완료하는 데 필요한 구성을 가지고 있지 않습니다. 메시지에는 누락 된 구성에 대한 세부 정보가 포함됩니다.
missing-scope
조직, 키 또는 현재 사용자에게이 요청을 수행하는 데 필요한 권한 범위가 없습니다.
limit-exceeded
조직, 키 또는 현재 사용자에게 부과 된 한도를 위반하여 요청을 완료 할 수 없습니다. 예를 들어, 한 달에 두 개의 iCloud 계정에 액세스 할 수있는 사용자는 세 번째 계정에 액세스하려고하면이 오류가 발생합니다.
session-expired
이 요청에 사용하려는 세션이 API에 의해 만료 된 것으로 표시되었습니다. 계속 진행하기 전에 새 유효한 세션을 만들어야합니다.
invalid-credentials
제공된 자격 증명은 외부 서비스에 의해 거부되었습니다. 소스가 존재하지 않습니다 (즉, 유효하지 않은 사용자 이름) 또는 자격 증명 페이로드가 틀립니다 (예 : 잘못된 암호).
source-locked
소스는 외부 서비스에 의해 잠겨져 있으며 사용자가 잠금을 해제 할 때까지 API에서 액세스 할 수 없습니다. API 메시지는 관련 서비스에 대해이 작업을 수행하는 방법에 대한 지침을 제공합니다.
code-required
세션을 만들려고하는 원본에 MFA (Multi-Factor Authentication)가 활성화되어 있습니다. API가 MFA 프로세스를 트리거 했으므로 다음 세션 생성시이 프로세스 중에 제공된 코드를 제공해야합니다.
세션 생성 흐름에 대한 자세한 내용은 액세스하려는 서비스의 서비스 참조를 참조하십시오.
code-rate-limited
사용자가 유효하지 않은 코드를 사용하여 세션을 만들려고했으며 서비스에 의해 속도가 제한되었습니다. 재 시도하기 전에 적어도 한 시간을 기다리는 것이 좋습니다.
choice-required
액세스하려는 소스에 다중 인증 (MFA)의 하위 세트 인 2 단계 인증 (2SV)이 활성화되어 있습니다. 이 응답의 일부로 API는 2SV 프로세스를 트리거 할 수있는 장치 목록을 제공합니다. 이 장치는 프로세스의 다음 단계에 필요할 2SV 코드를 수신합니다.
세션 생성 흐름에 대한 자세한 내용은 액세스하려는 서비스의 서비스 참조를 참조하십시오.
task-error
일반 작업 오류가 발생했습니다. 폴링 또는 작업을 다시 시도하면 문제가 해결 될 수 있습니다. 문제가 지속되면 지원 센터에 문의하십시오.
iCloud 서비스 오류 코드
icloud-terms-not-accepted
사용자가 최신 iCloud 서비스 약관에 동의하지 않았습니다. iOS 또는 macOS 기기에서 자신의 계정으로 App Store에 로그인하거나 iCloud.com 으로 이동하여 약관에 동의할 수 있습니다.
icloud-account-not-verified
iCloud 계정과 연관된 기본 이메일 주소는 아직 확인되지 않았습니다. 계정을 활성화하려면 이메일 확인 프로세스를 완료해야합니다. appleid.apple.com 에 로그인하여 확인 프로세스를 관리 할 수 있습니다.
icloud-web-access-required
해당 계정의 웹에서 iCloud 데이터 접근이 꺼져 있습니다. Apple 지원 문서를 참조하여 활성화하세요.
icloud-adp-enabled
iCloud 계정에 고급 데이터 보호 기능이 활성화되어 있지만 API에서 지원하지 않습니다. 비활성화 방법은 Apple 지원 문서를 참조하세요.
icloud-signin-rate-limited
Apple에서 iCloud 계정 접근 속도를 제한하고 있습니다. 이는 일반적으로 세션 초기화 시도가 너무 많이 실패했기 때문입니다. 나중에 다시 시도해 주세요.
icloud-account-locked
Apple에서 iCloud 계정 접근을 차단했습니다. 일반적으로 보안상의 이유로 차단됩니다. 계정 잠금 해제에 대한 자세한 내용은 Apple 지원에 문의하세요.
icloud-service-not-activated
작업을 완료하는 데 필요한 iCloud 서비스가 사용중인 iCloud 계정에서 활성화되지 않았습니다. 예를 들어, 사용자가 계정에서 iCloud 사진 icpl.photos 활성화하지 않은 경우 icpl.photos 를 검색하려고하면이 오류가 발생합니다.
사용자가 서비스의 관련 설정을 전환하여 활성화되었는지 확인하십시오.
icloud-service-outage
iCloud 중단으로 인해 작업을 완료 할 수 없습니다. 이는 매우 드물고 일반적으로 일시적이므로 몇 분 내에 다시 시도하면 성공합니다. 그러나 문제가 지속되면 iCloud 상태 페이지 및 API 상태 페이지 에서 자세한 정보를 찾아 지원 센터에 문의 하십시오 .