오류

업데이트 됨
Cover image for: 오류

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-service-not-activated

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

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

icloud-service-outage

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

어떻게 도와 드릴까요?

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

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

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

지원 섹션으로 이동 › 엔터프라이즈 팀에 문의하십시오. ›
우리의 멋진 지원 팀

이 기사를 개선 할 수 있습니까?

사용자의 의견을 듣고 싶습니다. 전자 메일을 보내지 말고, 의견을 남기거나, 트윗하지 마십시오. @reincubate?

© 2008 - 2021 Reincubate Ltd. 판권 소유. 영국과 웨일즈에 등록 #5189175, VAT GB151788978. Reincubate® 및 Camo®는 등록 상표입니다. 개인 정보 정책 & 자귀. 런던에서 Built로 지어졌습니다.