릴레이 서비스 릴레이 서비스
세션
페어링 프로세스는 API 사용자와 Reincubate Relay 앱 인스턴스 간의 연결을 설정하는 데 사용됩니다. 기본적으로, 페어링되지 않은 경우 Reincubate Relay는 페어링 코드를 표시합니다. 다음 호출을 통해 유효한 세션을 만들려면 사용자가이를 응용 프로그램에 제공해야합니다.
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": "rirelay.instance"
},
"payload": {
"code": "<Reincubate Relay pairing code>"
}
}'
세션이 생성되면 세션 객체의 source 속성을 통해 앱 인스턴스에 대한 정보를 볼 수 있습니다. 이것은 다음과 같아야합니다.
{
"id": "<session ID>",
"resource": "session",
...
"source": {
"id": "<source ID>",
"resource": "source",
"user": "<user ID>",
"type": "rirelay.instance",
"identifier": "ee360f13-1b54-4d8c-8876-e5f573f0ba1c",
"info": null,
"parent": null,
"children": {
"data": [
{
"id": "<child source ID>",
"resource": "source",
"user": "<user ID>",
"type": "rirelay.source",
"identifier": "70a4982e-5893-4a5f-8af6-19db834d378d",
"info": {
"is_encrypted": true,
"apple_model_id": "iPhone10,4",
"apple_serial": "FFABCZGTJC12",
"name": "iPhone 8",
"ios_version": "13.2"
},
"children": {
"data": [],
"has_more": false,
"total_count": 0,
"url": "/sources/<child source ID>/children"
},
"state": "active",
"date_created": "2019-10-08T09:02:15.770532Z"
}
],
"has_more": false,
"total_count": 0,
"url": "/sources/<source ID>/children"
},
"state": "active",
"date_created": "2019-10-08T08:58:33.861941Z"
},
...
}
구독
다른 서비스와 달리 API가 Reincubate Relay 소스에서 데이터 검색을 시작하려면 구독이 필요합니다. 이는 앱 사용자가 액세스하는 데이터를 정확하게 이해하는 데 도움이됩니다.
구독은 Reincubate Relay 인스턴스의 하위 인 rirelay.source 유형 소스에 대해서만 만들 수 있습니다. 소스를 폴링 할 때 사용할 세션도 지정해야합니다.
curl https://ricloud-api.reincubate.com/subscriptions \
-X POST \
-H 'Authorization: Token <your key_token>' \
-H 'Content-Type: application/json' \
-d '{
"session": "<session ID>",
"source": "<child source ID>",
"poll_payload": {
"data_types": ["ios_messages.messages"]
}
}'
사용자가 Reincubate Relay 앱 인터페이스에서 특정 장치에 대한 액세스를 허용 할 때까지 구독은 보류 상태로 유지됩니다. 허용되면 상태는 active 전환됩니다.
구독 활성화시 초기 폴이 즉시 생성 된 다음 Reincubate Relay 앱이 API에 새 데이터를 통지하면 후속 폴링이 생성됩니다.
투표소
활성 구독이있는 소스에 대해 설문 조사를 수동으로 작성할 수도 있습니다. 검색된 데이터의 문제를 해결하거나 새로운 데이터 유형을 테스트 할 때 유용합니다.
curl https://ricloud-api.reincubate.com/polls \
-X POST \
-H 'Authorization: Token <your key_token>' \
-H 'Content-Type: application/json' \
-d '{
"subscription": "<subscription ID>",
"payload": {
"data_types": ["ios_phone.calls", "whatsapp.messages"]
}
}'
행사
새 폴링을 생성하는 구독 또는 세션 만료와 같은 비동기 변경에 대한 정보를 유지하려면 구현에서 웹 후크 엔드 포인트를 통해 API로부터 이벤트 알림을 수신해야합니다.
웹 후크 엔드 포인트 설정 및 구성 방법에 대한 자세한 내용은 웹 후크 구성을 참조하십시오.
정보 유형
rirelay.source 소스에 대한 중첩 정보를 포함하는 rirelay.instance 소스에서 정보 검색만 지원합니다.
rirelay.instance.info 속성
| 이름 | 유형 | 설명 |
|---|---|---|
id | 소스 ID | 이 Relay 인스턴스에 해당하는 소스 개체의 ID입니다. |
version | str | Reincubate Relay 앱의 버전입니다. |
os | str | Reincubate Relay 앱이 실행 중인 운영 체제의 식별자입니다. |
sources | rirelay.source.info 목록 | 인스턴스와 연결된 소스 목록입니다. |
date_created | 날짜 시간 | 이 인스턴스가 처음 표시된 날짜/시간입니다. |
date_last_seen | 날짜 시간 | 이 인스턴스를 마지막으로 본 날짜/시간입니다. |
rirelay.source.info 속성
| 이름 | 유형 | 설명 |
|---|---|---|
id | 소스 ID | 이 릴레이 소스에 해당하는 소스 개체의 ID입니다. |
uid | str | 릴레이 소스의 고유한 iOS 장치 ID입니다. |
info | 중첩된 rirelay.source.info.info | 이 릴레이 소스의 메타데이터입니다. |
date_created | 날짜 시간 | 이 소스가 처음 표시된 날짜/시간입니다. |
date_last_seen | 날짜 시간 | 이 소스를 마지막으로 본 날짜/시간입니다. |
rirelay.source.info.info 속성
name , ios_version , apple_model_id , apple_serial 및 is_encrypted 도 Source 객체의 중첩 info 데이터에 포함되므로 API 끝점을 통해 직접 액세스할 수 있습니다.
같은 다른 속성의 경우 phone_number 에 대한 전체 투표 rirelay.instance.info 이 API에서 저장되지 식별 정보를 개인적으로 그대로 - 필요합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
name | str | 릴레이 소스의 이름입니다. Source.info에서 Source.info 있습니다. |
ios_version | str | Relay 소스에서 실행되는 iOS 버전, 즉 13.4 . Source.info에서 Source.info 있습니다. |
apple_model_id | str | 릴레이 소스의 모델 ID, 즉 iPhone7,2 . Source.info에서 Source.info 있습니다. |
apple_serial | str | 릴레이 소스의 일련 번호, 예: F4KPWDR7G5DN . Source.info에서 Source.info 있습니다. |
phone_number | 선택적, str | 릴레이 소스의 전화번호입니다. 기기에서 셀룰러 기능이 활성화되어 있지 않으면 비어 있습니다(예: SIM 없음 또는 Wi-Fi만 해당). |
is_encrypted | 부울 | 릴레이 소스가 암호화된 백업을 생성하도록 설정되었는지 여부. Source.info에서 Source.info 있습니다. |
자료형
Reincubate Relay 앱 데이터 유형
| 식별자 | 설명 |
|---|---|
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 통화 기록을 검색합니다. |
whatsapp_business.messages |
Retrieves WhatsApp for Business messages. |
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 메시지를 검색합니다. |
릴레이 집계 데이터 유형 재 인큐베이션
| 식별자 | 설명 |
|---|---|
.photos | 이미지 파일에 대한 백업을 검색합니다. |
.videos | 비디오 파일에 대한 백업을 검색합니다. |
.recordings | 녹음 파일에 대한 백업을 검색합니다. |
.voicemails | 음성 메일 파일에 대한 백업을 검색합니다. |
.app_usage | 앱 사용 정보에 대한 백업을 스캔합니다. |
.installed_apps | 설치된 앱 정보에 대한 백업을 검색합니다. |
.locations | 백업에서 위치를 검색합니다. |
.linked_watches | 연결된 Apple Watch 정보에 대한 백업을 검색합니다. |
iOS 메시지
메시지
| 데이터 유형 ID | ios_messages.messages |
데이터 속성
message 데이터 유형을 확장합니다.
샘플 데이터
{
"id": "a1b2c3d4",
"data_type": "message",
"conversation_id": "w6x7y8z9",
"handle": "vodafone",
"type": "SMS",
"text": "Hi from Vodafone!",
"attachments": [],
"group_handles": [
"+441234567890",
"renate@reincubate.com"
],
"from_me": false,
"deleted": false,
"date": "2020-01-01T00:00:00.000000Z"
}
iOS 연락처
콘택트 렌즈
| 데이터 유형 ID | ios_contacts.contacts |
데이터 속성
contact 데이터 유형을 확장합니다.
샘플 데이터
{
"id": "2cf6a837304d6614",
"data_type": "contact",
"first_name": "John",
"middle_name": "'Gala'",
"last_name": "Appleseed",
"prefix": "Mr.",
"suffix": "Jr.",
"nickname": "John'o",
"records": [
{
"type": "Phone",
"name": "MAIN",
"value": "1-800-MY-APPLE"
},
{
"type": "Phone",
"name": "UK",
"value": "0800 039 1010"
},
{
"type": "URL",
"name": "HOMEPAGE",
"value": "http://www.apple.com"
},
{
"type": "URL",
"name": "HOMEPAGE",
"value": "http://www.apple.com/uk/"
},
{
"City": "Cupertino",
"State": "CA",
"ZIP": "95014",
"name": "WORK",
"CountryCode": "US",
"Country": "United States",
"Street": "1 Infinite Loop",
"type": "Address",
"SubLocality": null,
"Municipality": null
}
],
"organisation": "Apple Inc.",
"department": "Marketing",
"jobtitle": "VP Juicing",
"birthday": "1976-04-01 00:00:00.000000Z"
}
iOS 전화
전화
| 데이터 유형 ID | ios_phone.calls |
데이터 속성
call 데이터 유형을 연장합니다.
샘플 데이터
{
"id": "24116c5b16b85217",
"data_type": "call",
"call_type": "Phone",
"address": "07123456789",
"duration": 5.131359,
"answered": false,
"from_me": true,
"date": "2015-07-20 10:23:27.538011"
}
iOS 캘린더
행사
| 데이터 유형 ID | ios_calendar.events |
데이터 속성
event 데이터 유형을 확장합니다.
샘플 데이터
{
"id": "3",
"unique_identifier": "f5fcf872-34f6-3f60-ba03-74d5a7a3bbbb",
"calendar": "Home",
"calendar_id": "477a2001537fe178d6b77cdceb8bac2e",
"calendar_store": "Default",
"summary": "Christmas Day",
"description": "Bank holiday in the UK",
"start_date": "2017-12-25T00:00:00.000000",
"end_date": "2017-12-25T23:59:59.000000",
"start_time_zone": None,
"end_time_zone": None,
"all_day": True,
"travel_time": None,
"recurrence": {
"interval": 1,
"repeat": "Yearly",
"repeat_end_date": None,
"specifier": ""
},
"location": None,
"start_location": None,
"attendees": ["John Appleseed"],
"attached_url": None,
"creation_date": None
}
iOS 노트
노트
| 데이터 유형 ID | ios_notes.notes |
데이터 속성
note 데이터 형식을 확장합니다.
iOS 건강
iOS Health 앱 및 HealthKit 프레임 워크와 관련된 데이터입니다.
데이터
| 데이터 유형 ID | ios_health.data |
ios_health.profile 속성
| 이름 | 유형 | 설명 |
|---|---|---|
info_type | 문자열, 항상 ios_health.profile | 항목 데이터 유형 ID입니다. |
gender | 선택적 문자열 | 다음 중 하나: Female , Male , Other . |
date_of_birth | 선택적 날짜 | 프로필 소유자의 생년월일. |
weight | 선택적 플로트 | 프로필 소유자의 체중 측정값(킬로그램)입니다. |
height | 선택적 플로트 | 프로필 소유자의 키 측정값(미터)입니다. |
blood_type | 선택적 문자열 | 프로필 소유자의 혈액형입니다. |
fitzpatrick_skin_type | 선택적 문자열 | 프로필 소유자의 Fitzpatrick 피부 유형. Type I , Type II , Type II , Type IV , Type V 중 하나입니다. |
ios_health.profile 샘플
{
"info_type": "ios_health.profile",
"gender": "Female",
"date_of_birth": "1988-08-22",
"weight": 75.2543977,
"height": 1.9812,
"blood_type": "O+",
"fitzpatrick_skin_type": "Type V"
}
ios_health.sample 속성
| 이름 | 유형 | 설명 |
|---|---|---|
id | 끈 | 항목 ID. |
data_type | 끈 | 항목 데이터 유형 ID입니다. iOS 건강 데이터 유형 중 하나입니다. |
type | 끈 | 샘플 유형. 다음 중 하나: quantity , binary , category . |
value | 문자열, 부동 소수점, 정수 중 하나 | 샘플 값. 이 필드의 유형은 샘플 type 속성에 따라 다릅니다. |
unit | 선택적 문자열 | 기본이 아닌 샘플 단위인 경우 설정합니다. |
was_user_entered | 부울 | 사용자가 이 측정을 수동으로 입력했는지 여부. |
start_date | 날짜 시간 | 샘플링 기간이 시작된 때. |
end_date | 날짜 시간 | 샘플링 기간이 종료되었을 때. |
iOS 건강 데이터 유형 :
ios_health.body_mass_indexios_health.body_fat_percentageios_health.heightios_health.weightios_health.lean_body_massios_health.heart_rateios_health.stepsios_health.walking_running_distanceios_health.resting_energyios_health.active_energyios_health.flights_climbedios_health.oxygen_saturationios_health.blood_glucoseios_health.systolic_blood_pressureios_health.diastolic_blood_pressureios_health.blood_alcohol_contentios_health.peripheral_perfusion_indexios_health.total_fatios_health.polyunsaturated_fatios_health.monounsaturated_fatios_health.saturated_fatios_health.dietary_cholesterolios_health.sodiumios_health.carbohydratesios_health.fibreios_health.dietary_sugarios_health.dietary_energyios_health.proteinios_health.vitamin_aios_health.vitamin_b6ios_health.vitamin_b12ios_health.vitamin_cios_health.vitamin_dios_health.vitamin_eios_health.vitamin_kios_health.calciumios_health.ironios_health.thiamineios_health.riboflavinios_health.niacinios_health.folateios_health.biotinios_health.pantothenic_acidios_health.phosphorousios_health.iodineios_health.magnesiumios_health.zincios_health.seleniumios_health.copperios_health.manganeseios_health.chromiumios_health.molybdenumios_health.chlorideios_health.potassiumios_health.number_of_times_fallenios_health.electrodermal_activityios_health.inhaler_usageios_health.respiratory_rateios_health.body_temperatureios_health.sleep_analysisios_health.forced_vital_capacityios_health.forced_expiration_volume_1ios_health.peak_expiratory_flow_rateios_health.caffeineios_health.workoutios_health.blood_pressure_correlationios_health.cycling_distanceios_health.waterios_health.uv_indexios_health.basal_body_temperatureios_health.cervical_mucus_qualityios_health.ovulation_test_resultsios_health.menstruationios_health.spottingios_health.sexual_activity
샘플 데이터
{
"id": "a1b2c3d41",
"data_type": "ios_health.walking_running_distance",
"type": "quantity",
"value": 6.08,
"was_user_entered": false,
"start_date": "2016-07-04T18:11:54.000000Z",
"end_date": "2016-07-04T18:12:09.000000Z"
}, {
"id": "a1b2c3d42",
"data_type": "ios_health.steps",
"type": "quantity",
"value": 8.0,
"was_user_entered": false,
"start_date": "2016-07-04T18:11:54.000000Z",
"end_date": "2016-07-04T18:12:09.000000Z"
}, {
"id": "a1b2c3d43",
"data_type": "ios_health.caffeine",
"type": "quantity",
"value": 800.0,
"unit": "mg",
"was_user_entered": true,
"start_date": "2016-07-04T18:11:54.000000Z",
"end_date": "2016-07-04T18:12:09.000000Z"
}
iOS 사파리
역사
| 데이터 유형 ID | ios_safari.history |
데이터 속성
visit 데이터 유형을 연장합니다.
샘플 데이터
{
"data_type": "visit",
"url": "https://reincubate.com/",
"title": "Reincubate: the app data company",
"date_created": "2020-01-01T00:00:00.000000Z"
}
쿠키
| 데이터 유형 ID | ios_safari.cookies |
데이터 속성
cookie 데이터 유형을 확장합니다.
샘플 데이터
{
"data_type": "cookie",
"name": "sample_cookies",
"value": "sample_value",
"domain": "reincubate.com",
"path": "/",
"flags": "",
"creation_date": "2020-01-01T00:00:00.000000Z",
"expiry_date": "2020-01-01T00:00:00.000000Z"
}
WhatsApp & WhatsApp for Business
WhatsApp Messages
| 데이터 유형 ID | whatsapp.messages |
속성
message 데이터 유형을 확장합니다.
WhatsApp Calls
| 데이터 유형 ID | whatsapp.calls |
속성
call 데이터 유형을 연장합니다.
WhatsApp for Business Messages
| Data type ID | whatsapp_business.messages |
속성
message 데이터 유형을 확장합니다.
비베르
통화
viber.messages | Viber 메시지를 검색합니다. |
viber.calls | Viber 통화 기록을 검색합니다. |
viber.conversations | Viber 대화를 검색합니다. |
viber.contacts | Viber 연락처를 검색합니다. |
메시지
| 데이터 유형 ID | viber.messages |
속성
message 데이터 유형을 확장합니다.
통화
| 데이터 유형 ID | viber.calls |
속성
call 데이터 유형을 연장합니다.
대화
| 데이터 유형 ID | viber.conversations |
속성
conversation 데이터 유형을 확장합니다.
콘택트 렌즈
| 데이터 유형 ID | viber.contacts |
속성
contact 데이터 유형을 확장합니다.
ik
메시지
| 데이터 유형 ID | kik.messages |
속성
message 데이터 유형을 확장합니다.
콘택트 렌즈
| 데이터 유형 ID | kik.contacts |
속성
contact 데이터 유형을 확장합니다.
인상
hike.messages | 하이킹 메시지를 검색합니다. |
hike.posts | 하이킹 게시물을 검색합니다. |
메시지
| 데이터 유형 ID | hike.messages |
속성
message 데이터 유형을 확장합니다.
게시물
| 데이터 유형 ID | hike.posts |
속성
message 데이터 유형을 확장합니다.
위챗
메시지
| 데이터 유형 ID | wechat.messages |
속성
message 데이터 유형을 확장합니다.
부싯깃
메시지
| 데이터 유형 ID | tinder.messages |
속성
message 데이터 유형을 확장합니다.
선
메시지
| 데이터 유형 ID | line.messages |
속성
message 데이터 유형을 확장합니다.
페이스 북 메신저
메시지
| 데이터 유형 ID | facebook.messenger |
속성
message 데이터 유형을 확장합니다.
스냅 챗
메시지
| 데이터 유형 ID | snapchat.messages |
속성
message 데이터 유형을 확장합니다.
이야기
| 데이터 유형 ID | snapchat.stories |
속성
message 데이터 유형을 확장합니다.
스카이프
메시지
| 데이터 유형 ID | skype.messages |
속성
message 데이터 유형을 확장합니다.