重新孵育中继服务

更新
Cover image for: 重新孵育中继服务

届会

配对过程用于在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 可选字符串 FemaleMaleOther
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 样品类型。之一: quantitybinarycategory
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数据类型。

我们能帮你什么吗?

我们的支持团队在这里提供帮助!

我们的办公时间是格林威治标准时间周一至周五上午9点至下午5点。 时间目前是 11:47 PM的 GMT。

我们力争在一个工作日内答复所有垂询。

转到支持部分 › 联系企业团队 ›
我们的支持团队非常棒

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

我们喜欢听取用户的意见:为什么不给我们发电子邮件,发表评论或发推文 @reincubate?

© 2008 - 2020 Reincubate Ltd. 保留所有权利。 在英格兰和威尔士注册 #5189175, VAT GB151788978. Reincubate®是注册商标。 隐私政策 & 条款. 我们推荐多因素认证。 在伦敦建立了爱情。