Apple iCloud 서비스

업데이트 됨

API는 Apple의 iCloud 서비스에서 다양한 데이터 및 파일을 검색하는 것을 지원합니다. 여기에는 기기 iCloud 백업 데이터, 내 iPhone 데이터 찾기 및 거의 실시간에 가까운 여러 CloudKit 데이터 소스에 대한 액세스가 포함됩니다.

세션

API에서 iCloud 서비스에 대한 세션을 설정하는 것은 iCloud 계정에 로그인하는 것만큼이나 간단합니다. 계정에서 다중 요소 인증 (예 : 2FA 또는 2SV)을 사용하도록 설정 한 경우 세션을 만들 때 여러 번 시도해야 할 수 있습니다.

세션을 만드는 첫 번째 호출은 아래와 같습니다.

curl https://ricloud-api.reincubate.com/sessions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "source": {
    "user": "1",
    "type": "icloud.account",
    "identifier": "<iCloud account username>"
  },
  "payload": {
    "password": "<iCloud account password>"
  }
}'

비 2FA / 비 2SV 사용 계정의 경우 제공된 자격 증명이 유효한 경우 활성 세션을 설정하기에 충분합니다.

그러나 2FA를 사용하는 계정은 code-required 오류 응답을 받게되며 2FA 프로세스는 2FA 코드를 보낼 계정에 연결된 기기에서 실행됩니다. 이 코드는 다음 세션 생성 호출에서 API에 제공되어야합니다.

curl https://ricloud-api.reincubate.com/sessions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "source": {
    "user": "1",
    "type": "icloud.account",
    "identifier": "<iCloud account username>"
  },
  "payload": {
    "password": "<iCloud account password>",
    "code": "<fresh 2FA code>"
  }
}'

마지막으로 2SV를 사용하는 계정은 2SV 프로세스를 완료하기 위해 트리거 될 수있는 계정에 연결된 가능한 장치 목록과 함께 choice-required 오류 응답을 받게됩니다.

curl https://ricloud-api.reincubate.com/sessions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "source": {
    "user": "1",
    "type": "icloud.account",
    "identifier": "<iCloud account username>"
  },
  "payload": {
    "password": "<iCloud account password>",
    "choice": "<choice identifier from choices fields of `choice-required` error>"
  }
}'

이 호출은 선택된 장치로 전송 될 코드를 트리거 할 것이며, 페이로드 에서처럼 세션 초기화 프로세스를 완료하기 위해 사용될 수 있습니다.

세션 생성 페이로드에서 허용하는 매개 변수는 아래 표에 요약되어 있습니다.

이름 유형 기술
암호 iCloud 계정의 암호입니다.
암호 선택 사항, 문자열 iCloud 계정에 다중 요소 (2FA 등)가 활성화 된 경우이 매개 변수가 필요합니다.
선택 선택 사항, 문자열 iCloud 계정에 2SV가 활성화 된 경우이 매개 변수는 세션 생성 프로세스 중에 필요합니다.

소스 유형

식별자 기술
icloud.account 기본 소스 iCloud 계정에 해당합니다.
icloud.backup iOS 장치의 iCloud 백업.

투표소

iCloud 서비스는 모든 폴 페이로드 스키마 속성을 지원합니다.

소스 정보 검색

이 폴링 유형은 대상 소스에 대한 정보를 검색합니다. 결과는 JSON 형식으로 게시됩니다.

예를 들어 icloud.account 소스 정보는 계정 세부 정보, iCloud 백업 목록 ( icloud.backup 하위 소스) 및 기타 메타 정보를 반환합니다.

cURL 사용

curl https://ricloud-api.reincubate.com/polls \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "session": "<session ID>",
  "payload": {
    "info_types": ["*"]
  }
}'

* ricloud-py * 사용

import ricloud

# The ID of a session we made earlier.
session_id = "<session ID>"

poll = ricloud.Poll.create(
  session=session_id,
  payload={
    "info_types": ["*"]
  }
)

데이터 검색

이 폴링 유형은 대상 세션에서 데이터를 검색하고 처리합니다. 결과는 JSON 형식으로 게시됩니다.

특정 데이터 유형에 대한 자세한 정보 는 사용 가능한 데이터 유형 목록을 참조하십시오.

cURL 사용

curl https://ricloud-api.reincubate.com/polls \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "session": "<session ID>",
    "payload": {
        "data_types": ["icpl.photos"]
    }
}'

* ricloud-py * 사용

import ricloud

# The ID of a session we made earlier.
session_id = "<session ID>"

poll_payload = {
    "data_types": ["icpl.photos"]
}

poll = ricloud.Poll.create(
  session=session_id,
  payload=poll_payload,
)

파일 검색 중

files poll payload 속성은 백업에서 이진 파일을 검색하도록 지정했습니다. ID는 일반적으로 사진과 같은 직접 파일 참조를 포함하거나 메시지 데이터 유형과 같은 첨부 파일을 포함하는 데이터 유형에 대한 이전 폴링에서 검색됩니다.

cURL 사용

curl https://ricloud-api.reincubate.com/polls \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "session": "<session ID>",
    "payload": {
        "files": [
            "icpl://01a266abcd6c1a74056891b9c7ed9016b0c319ecabc1e7d658896f59c305768f71961fef92091cfed21f",
            "icpl://0167ba732e5f53e20efd7b0a1d859abcdd97e698af01afc3ab2f1d65880f7abcce0bfb89142ee770fac5"
        ]
    }
}'

* ricloud-py * 사용

import ricloud

# The ID of a session we made earlier.
session_id = "<session ID>"

poll_payload = {
    'files': [
        'icpl://01a26621ad6c1a74056891b9c7ed9016b0c319ec0d01e7d658896f59c305768f71961fef92091cfed21f',
        'icpl://0167ba732e5f53e20efd7b0a1d8593b0dd97e698af01afc3ab2f1d65880f713dce0bfb89142ee770fac5',
    ]
}

poll = ricloud.Poll.create(
  session=session_id,
  payload=poll_payload,
)

자료형

iCloud 데이터 유형

식별자 기술
icpl.photos iCloud 사진 라이브러리 파일을 검색합니다.
mme_contacts.contacts iCloud에 저장된 iOS 연락처 데이터를 검색합니다.
mme_calendar.events iCloud에 저장된 iOS 캘린더 데이터를 가져옵니다.
mme_notes.notes iCloud에 저장된 iOS Notes 데이터를 검색합니다.
callkit.calls CallKit 동기화 된 iOS 전화 데이터를 검색합니다.
cloudkit_safari.history iCloud에 저장된 Safari 브라우저 기록 데이터를 검색합니다.
fmip.locations 내 iPhone 위치 데이터를 검색하십시오.

iCloud 백업 앱 데이터 유형

식별자 기술
ios_messages.messages iMessage 및 SMS를 포함한 iOS 메시지 데이터를 검색합니다.
ios_contacts.contacts iOS 주소록 데이터를 검색합니다.
ios_phone.calls iOS 전화 데이터를 가져옵니다.
ios_calendar.events iOS 캘린더 데이터를 가져옵니다.
ios_notes.notes iOS Notes 데이터를 가져옵니다.
ios_health.data iOS 상태 데이터를 가져옵니다.
ios_safari.history Safari 브라우저 기록 데이터를 검색합니다.
ios_safari.cookies Safari 쿠키 데이터를 검색합니다.
whatsapp.messages WhatsApp 메시지를 검색합니다.
whatsapp.calls WhatsApp 통화 내역을 검색합니다.
viber.messages Viber 메시지를 검색합니다.
viber.calls Viber 호출 기록을 가져옵니다.
viber.conversations Viber 대화를 가져옵니다.
viber.contacts Viber 연락처를 검색합니다.
kik.messages Kik 메시지를 검색합니다.
kik.contacts Kik 연락처를 검색합니다.
hike.messages 하이킹 메시지를 검색합니다.
hike.posts 하이킹 게시물을 검색합니다.
wechat.messages WeChat 메시지를 검색합니다.
tinder.messages Tinder 메시지를 검색합니다.
line.messages 행 메시지를 검색합니다.
facebook.messages Facebook 메시지를 검색합니다.
snapchat.messages Snapchat 메시지를 검색합니다.
snapchat.stories Snapchat 기사를 검색합니다.
skype.messages Skype 메시지를 검색합니다.

iCloud 백업 집계 데이터 유형

식별자 기술
.photos 이미지 파일에 대한 iCloud 백업을 검사합니다.
.videos 비디오 파일에 대한 iCloud 백업을 검사합니다.
.recordings 파일 기록을 위해 iCloud 백업을 검사합니다.
.voicemails iCloud 백업에서 음성 메일 파일을 검색합니다.
.app_usage iCloud 백업을 검색하여 앱 사용 정보를 찾습니다.
.installed_apps 설치된 앱 정보에 대한 iCloud 백업을 검사합니다.
.locations 위치에 대한 iCloud 백업을 검사합니다.
.linked_watches 연결된 Apple Watch 정보에 대한 iCloud 백업을 검색합니다.

iCloud 사진 보관함

사진 icpl.photos

iCloud Photo Library 서비스에 저장된 사진을 검색합니다.

속성 기술
출처 icloud.account
환경 Settings > [username] > iCloud > Photos > iCloud Photo Library

콜킷

CallKit callkit.calls 호출

CallKit 서비스와 동기화 된 통화 기록을 검색합니다.

오류

callkit-uninitialised

이 계정에 대해 CallKit 서비스가 설정되지 않았 음을 나타냅니다. iCloud 계정 소유자는 다음 단계를 통해 iCloud 계정과 연관된 iOS 장치를 사용하여이 오류를 해결할 수 있습니다.-장치가 Wi-Fi에 연결되어 있는지 확인하십시오. - Settings > [username] > iCloud . -iCloud Drive를 끄고 변경 사항이 적용되기를 30 ~ 60 초 동안 기다리십시오. -이전 변경이 완료되면 iCloud Drive를 켭니다. 초기화가 시작됩니다.

이 과정을 수행 한 후에도 오류가 지속되면 지원 부서에 문의하십시오.

callkit-sync-disabled

이 경우 CallKit 서비스가 초기화되었지만 기기가 iCloud에 통화 내역을 동기화하기 위해 필요한 조건이 충족되지 않았습니다. API는 iCloud를 통해이 문제를 원격으로 해결하지만 iCloud 계정과 연결된 기기는 캐시 된 상태이므로 동기화 상태를 재평가 할 수 없습니다.

iCloud 계정 소유자는 다음 단계를 통해 디바이스가 통화 기록 동기화 조건을 다시 확인하도록 트리거 할 수 있습니다.

  • Settings > [username] > iCloud .
  • iCloud Drive를 끄고 변경 사항이 적용되기를 30 ~ 60 초 동안 기다리십시오.
  • 이전 변경이 완료되면 iCloud Drive를 켭니다. 초기화가 시작됩니다.

문제 해결

  • 최근 통화 기록이 설문 조사 결과에 표시되지 않습니다.

이는 일반적으로 기기가 최신 통화 기록 레코드를 iCloud와 동기화하지 않았기 때문에 발생합니다. CallKit 서비스는 내부 iOS 서비스이며 설정에서 켜거나 끌 수 없거나 수동으로 동기화되도록 트리거 될 수 없습니다. 이로 인해 장치가 iCloud와 동기화되었거나 동기화되지 않았는지 여부가 불분명하여 누락 된 데이터를 디버그하는 것이 어려워 질 수 있습니다.

이 문제는 동기화 할 데이터가 많지 않은 계정 (~ 3 통화 미만)에 더 일반적이며, 이는 종종 계정 테스트의 경우 일 수 있습니다.

추천 :

  • 장치에 동기화 할 통화 기록 레코드가 몇 개 이상 있는지 확인하십시오. 테스트 결과 통화 기록 레코드가 두 개인 기기 만 iCloud 동기화 프로세스를 트리거하지 않는 것으로 나타났습니다.
  • 장치가 주기적 동기화를 수행 할 때까지 기다리십시오. 장치 사용 방법, 연결 상태 및 충전 상태에 따라 최대 12 시간이 걸릴 수 있습니다.
  • 장치를 전원에 연결하십시오. 이 상태에서는 장치가 동기화를 트리거 할 가능성이 높습니다.

  • 이전 통화 기록은 설문 조사 결과에 반환되지 않습니다.

CallKit 서비스는 장치간에 호출 기록 레코드를 동기화하고 이러한 레코드를 무기한 저장하지 않기 위해 설계되었습니다. 일반적으로 통화 기록 레코드는 CallKit에서 약 3 개월 동안 검색 할 수 있지만 iCloud의 내부 정리 프로세스에 따라 계정마다 다를 수 있습니다.

CloudKit

iCloud cloudkit_safari.history 브라우저 기록

iCloud 동기화 서비스에 저장된 Safari 브라우저 기록 데이터를 검색하십시오.

MobileMe

iCloud mme_contacts.contacts 연락처

iCloud에 저장된 iOS 연락처 데이터를 검색합니다.

iCloud mme_calendar.events 캘린더

iCloud에 저장된 iOS 캘린더 데이터를 가져옵니다.

iCloud의 메모 mme_notes.notes

iCloud에 저장된 iOS Notes 데이터를 검색합니다.

내 아이폰 찾기

위치 fmip.locations

검색 내 iPhone 위치 데이터 찾기.

iOS 앱

메시지 ios_messages.messages

iMessage 및 SMS를 포함한 iOS 메시지 데이터를 검색합니다.

연락처 ios_contacts.contacts

iOS 주소록 데이터를 검색합니다.

전화 ios_phone.calls

iOS 전화 데이터를 가져옵니다.

Calendar ios_calendar.events

iOS 캘린더 데이터를 가져옵니다.

노트 ios_notes.notes

iOS Notes 데이터를 가져옵니다.

건강 ios_health.data

iOS 상태 데이터를 가져옵니다. HealthKit 데이터라고도합니다.

원정 여행

백업에서 브라우저 기록 ios_safari.history

iCloud 백업에서 Safari 브라우저 기록 데이터를 검색합니다.

쿠키 ios_safari.cookies

iCloud 백업에서 Safari 쿠키 데이터를 검색합니다.

싸이 월드, 미투데이

메시지 whatsapp.messages

WhatsApp 메시지를 검색합니다.

whatsapp.calls 호출합니다.

WhatsApp 통화 내역을 검색합니다.

바이 버

메시지 viber.messages

Viber 메시지를 검색합니다.

viber.calls 호출 viber.calls

Viber 호출 기록을 가져옵니다.

대화 viber.conversations

Viber 대화를 가져옵니다.

연락처 viber.contacts

Viber 연락처를 검색합니다.

ik

메시지 kik.messages

Kik 메시지를 검색합니다.

연락처 kik.contacts

Kik 연락처를 검색합니다.

인상

메시지 hike.messages

하이킹 메시지를 검색합니다.

게시물 hike.posts

하이킹 게시물을 검색합니다.

위챗

메시지 wechat.messages

WeChat 메시지를 검색합니다.

부싯깃

메시지 tinder.messages

Tinder 메시지를 검색합니다.

메세지 line.messages

행 메시지를 검색합니다.

페이스 북

메시지 facebook.messages

Facebook 메시지를 검색합니다.

스냅 챗

Messages snapchat.messages

Snapchat 메시지를 검색합니다.

이야기 snapchat.stories

Snapchat 기사를 검색합니다.

스카이프

메시지 skype.messages

Skype 메시지를 검색합니다.

수집기

사진 .photos

iCloud 백업에서 이미지 파일을 수집합니다.

비디오 .videos

iCloud 백업에서 비디오 파일을 집계합니다.

녹음의 .recordings

iCloud 백업에서 파일을 수집합니다.

음성 메일의 .voicemails

iCloud 백업에서 음성 메일 파일을 수집합니다.

앱 사용 .app_usage

iCloud 백업에서 앱 사용 정보를 수집합니다.

설치된 응용 프로그램 .installed_apps

iCloud 백업에서 설치된 앱 정보를 수집합니다.

위치의 .locations

iCloud 백업의 위치 데이터를 집계합니다.

연결된 시계 .linked_watches

iCloud 백업에서 Apple Watch 정보에 연결된 집계.

파일 형식

식별자 기술
backup 또는 프로토콜 없음 iCloud 백업의 파일.
icpl iCloud 사진 보관함의 파일.

레거시 데이터 형식

iCloud 데이터 유형

유산 이름 새 이름
live_photos icpl.photos
mobileme_contacts mme_contacts.contacts
mobileme_calendar mme_calendar.events
mobileme_notes mme_notes.notes
live_call_history callkit.calls
web_browser_history cloudkit_safari.history
location fmip.locations

백업 데이터 유형

유산 이름 새 이름
photos .photos
videos .videos
recordings .recordings
voicemail .voicemails
app_usage .app_usage
installed_apps .installed_apps
locations .locations
linked_watches .linked_watches
sms ios_messages.messages
contacts ios_contacts.contacts
call_history ios_phone.calls
calendar_appointments ios_calendar.events
notes ios_notes.notes
healthkit ios_health.data
browser_history ios_safari.history
safari_cookies ios_safari.cookies
whatsapp_messages whatsapp.messages
whatsapp_call_history whatsapp.calls
viber_messages viber.messages
viber_call_history viber.calls
viber_conversations viber.conversations
viber_contacts viber.contacts
kik_messages kik.messages
kik_contacts kik.contacts
hike_messages hike.messages
hike_posts hike.posts
wechat_messages wechat.messages
tinder_messages tinder.messages
line_messages line.messages
facebook_messages facebook.messages
snapchat_messages snapchat.messages
snapchat_stories snapchat.stories
skype_messages skype.messages

어떻게 도와 드릴까요?

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

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

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

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

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