重新孵育中继服务

更新一个多星期前

届会

配对过程用于在API用户和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源检索数据。这是为了帮助应用程序的用户准确了解正在访问的数据。

只能根据rirelay.source类型的源创建订阅，该源是Reincubate Relay实例的子级。还必须指定轮询源时要使用的会话。

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"]
  }
}'

大事记

为了及时了解异步更改，例如创建新轮询的订阅或会话即将过期，您的实现将需要通过webhook端点从API接收事件通知。

有关如何设置和配置Webhook端点的详细信息，请参阅配置Webhooks 。

信息类型

中继服务当前仅支持从rirelay.instance来源检索信息。

`rirelay.instance.info`属性

名称	类型	描述
`id`	源ID	与此中继实例相对应的源对象的ID。
`version`	力量	Reincubate Relay应用程序的版本。
`os`	力量	Reincubate Relay应用程序正在运行的操作系统的标识符。
`sources`	`rirelay.source.info`列表	与实例关联的源列表。
`date_created`	约会时间	首次看到此实例的日期时间。
`date_last_seen`	约会时间	最后一次出现该实例的日期时间。

`rirelay.source.info`属性

名称	类型	描述
`id`	源ID	与此中继源相对应的源对象的ID。
`uid`	力量	中继源的唯一iOS设备ID。
`info`	嵌套`rirelay.source.info.info`	此中继源的元数据。
`date_created`	约会时间	首次看到此来源的日期时间。
`date_last_seen`	约会时间	上次看到此源的日期时间。

`rirelay.source.info.info`属性

名称	类型	描述
`name`	力量	中继源的名称。
`ios_version`	力量	在中继源上运行的iOS版本，即`13.4` 。
`apple_model_id`	力量	中继源的型号ID，即`iPhone7,2` 。
`apple_serial`	力量	中继源的序列号，即`F4KPWDR7G5DN` 。
`phone_number`	可选，str	中继源的电话号码。
`is_encrypted`	布尔	是否将中继源设置为生成加密备份。

资料类型

重新孵化Relay应用程序数据类型

识别码	描述
`ios_messages.messages`	检索iOS消息数据，包括iMessage和SMS。
`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 cookie数据。
`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`	检索微信消息。
`tinder.messages`	检索火种消息。
`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 Health数据类型之一。
`type`	串	样品类型。之一： `quantity` ， `binary` ， `category` 。
`value`	字符串，浮点数，整数之一	样本值。该字段的类型取决于样本`type`属性。
`unit`	可选字符串	设置是否为非默认采样单位。
`was_user_entered`	布尔值	用户是否手动输入此测量。
`start_date`	约会时间	采样期何时开始。
`end_date`	约会时间	采样期结束时。

iOS Health数据类型：

ios_health.body_mass_index
ios_health.body_fat_percentage
ios_health.height
ios_health.weight
ios_health.lean_body_mass
ios_health.heart_rate
ios_health.steps
ios_health.walking_running_distance
ios_health.resting_energy
ios_health.active_energy
ios_health.flights_climbed
ios_health.oxygen_saturation
ios_health.blood_glucose
ios_health.systolic_blood_pressure
ios_health.diastolic_blood_pressure
ios_health.blood_alcohol_content
ios_health.peripheral_perfusion_index
ios_health.total_fat
ios_health.polyunsaturated_fat
ios_health.monounsaturated_fat
ios_health.saturated_fat
ios_health.dietary_cholesterol
ios_health.sodium
ios_health.carbohydrates
ios_health.fibre
ios_health.dietary_sugar
ios_health.dietary_energy
ios_health.protein
ios_health.vitamin_a
ios_health.vitamin_b6
ios_health.vitamin_b12
ios_health.vitamin_c
ios_health.vitamin_d
ios_health.vitamin_e
ios_health.vitamin_k
ios_health.calcium
ios_health.iron
ios_health.thiamine
ios_health.riboflavin
ios_health.niacin
ios_health.folate
ios_health.biotin
ios_health.pantothenic_acid
ios_health.phosphorous
ios_health.iodine
ios_health.magnesium
ios_health.zinc
ios_health.selenium
ios_health.copper
ios_health.manganese
ios_health.chromium
ios_health.molybdenum
ios_health.chloride
ios_health.potassium
ios_health.number_of_times_fallen
ios_health.electrodermal_activity
ios_health.inhaler_usage
ios_health.respiratory_rate
ios_health.body_temperature
ios_health.sleep_analysis
ios_health.forced_vital_capacity
ios_health.forced_expiration_volume_1
ios_health.peak_expiratory_flow_rate
ios_health.caffeine
ios_health.workout
ios_health.blood_pressure_correlation
ios_health.cycling_distance
ios_health.water
ios_health.uv_index
ios_health.basal_body_temperature
ios_health.cervical_mucus_quality
ios_health.ovulation_test_results
ios_health.menstruation
ios_health.spotting
ios_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 Safari

历史


数据类型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的

留言内容


数据类型ID	`whatsapp.messages`

属性

扩展message数据类型。

来电


数据类型ID	`whatsapp.calls`

属性

扩展call数据类型。

-消息）	检索Viber消息。
	`viber.conversations`	检索Viber对话。
	[ `viber.contacts` ]（＃viber-contact
### 维伯

留言内容


数据类型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数据类型。

远足讯息）	检索远足消息。
### 远足

留言内容


数据类型ID	`hike.messages`

属性

扩展message数据类型。

帖子


数据类型ID	`hike.posts`

属性

扩展message数据类型。

微信

留言内容


数据类型ID	`wechat.messages`

属性

扩展message数据类型。

火种

留言内容


数据类型ID	`tinder.messages`

属性

扩展message数据类型。

线

留言内容


数据类型ID	`line.messages`

属性

扩展message数据类型。

Facebook Messenger

留言内容


数据类型ID	`facebook.messenger`

属性

扩展message数据类型。

Snapchat

留言内容


数据类型ID	`snapchat.messages`

属性

扩展message数据类型。

故事


数据类型ID	`snapchat.stories`

属性

扩展message数据类型。

Skype的

留言内容


数据类型ID	`skype.messages`

属性

扩展message数据类型。

届会

订阅内容

民意调查

大事记

信息类型

rirelay.instance.info属性

rirelay.source.info属性

rirelay.source.info.info属性

资料类型

iOS消息

留言内容

iOS通讯录

联络人

iOS手机

来电

iOS日历

大事记

iOS笔记

笔记

iOS健康

数据

iOS Safari

历史

饼干

WhatsApp的

留言内容

来电

留言内容

来电

对话内容

联络人

ik

留言内容

联络人

留言内容

帖子

微信

留言内容

火种

留言内容

线

留言内容

Facebook Messenger

留言内容

Snapchat

留言内容

故事

Skype的

留言内容

我们能帮你什么吗？

我们可以改进这篇文章吗？

`rirelay.instance.info`属性

`rirelay.source.info`属性

`rirelay.source.info.info`属性