오류

업데이트 됨

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

The request could not be completed as it would breach a limit imposed on your organisation, key or current user. For example, a user who is limited to access two iCloud account per month will receive this error if attempting to access a third account.

session-expired

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

invalid-credentials

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

source-locked

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

code-required

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

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

code-rate-limited

The user has attempted to create a session using an invalid code to often and has been rate-limited by the service. We recommend the user wait at least an hour before retrying.

choice-required

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

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

task-error

A generic task error occurred. Retrying the poll or task might resolve the issue. Please contact support if the issue persists.

iCloud service error codes

icloud-terms-not-accepted

The user has not accepted the latest iCloud Terms of Service. They can accept the terms by signing into the App Store on an iOS or macOS device using their account, or by going to iCloud.com.

icloud-account-not-verified

The primary email address associated with the iCloud account has not yet been verified. The user must complete the email verification process to activate the account. The verification process can be managed by signing into appleid.apple.com.

icloud-service-not-activated

The iCloud service necessary to complete the operation has not been activated on the iCloud account in use. For example, if the user has not enabled iCloud Photo Library on the account this error will be raised when attempting to retrieve icpl.photos.

Make sure the user has toggled on a service's associated settings to ensure it is activated.

icloud-service-outage

The operation could not be completed due to an iCloud outage. These are very rare and typically transient -- retrying within a few minutes should succeed. However, if the issue persists look for more information on the iCloud status page and the API status page, and contact support.

어떻게 도와 드릴까요?

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

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

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

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

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

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

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