重新孵育中继服务

更新
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

信息类型

Relay 服务目前仅支持从rirelay.instance源检索信息,其中包括任何关联rirelay.source源的嵌套信息。

rirelay.instance.info属性

名称类型描述
id来源 ID此 Relay 实例对应的源对象的 ID。
version字符串Reincubate Relay 应用程序的版本。
os字符串运行 Reincubate Relay 应用程序的操作系统的标识符。
sources rirelay.source.info列表与实例关联的源列表。
date_created约会时间首次看到此实例的日期时间。
date_last_seen约会时间上次看到此实例的日期时间。

rirelay.source.info属性

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

rirelay.source.info.info属性

请注意, nameios_versionapple_model_idapple_serialis_encrypted也包含在Source对象的嵌套info数据中,因此可以通过 API 端点直接访问。

对于其他属性,例如phone_number rirelay.instance.info进行完整轮询——因为这是 API 不存储的个人身份信息。

名称类型描述
name字符串中继源的名称。在Source.info可用。
ios_version字符串在 Relay 源上运行的 iOS 版本,即13.4 。在Source.info可用。
apple_model_id字符串Relay 源的型号 ID,即iPhone7,2 。在Source.info可用。
apple_serial字符串Relay 源的序列号,即F4KPWDR7G5DN 。在Source.info可用。
phone_number可选,str中继源的电话号码。如果设备上未启用蜂窝功能(即仅无 SIM 或 Wi-Fi),则为空。
is_encrypted布尔中继源是否设置为生成加密备份。在Source.info可用。

资料类型

重新孵化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检索 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可选字符串其中之一: 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 健康数据类型之一。
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.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数据类型。

Facebook Messenger

留言内容

数据类型 ID facebook.messenger

属性

扩展message数据类型。

Snapchat

留言内容

数据类型 ID snapchat.messages

属性

扩展message数据类型。

故事

数据类型 ID snapchat.stories

属性

扩展message数据类型。

Skype的

留言内容

数据类型 ID skype.messages

属性

扩展message数据类型。

我们能帮你什么吗?

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

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

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

我们的支持团队非常棒

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

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

© 2008 - 2022 Reincubate Ltd. 保留所有权利。 在英格兰和威尔士注册 #5189175, VAT GB151788978. Reincubate®和Camo®是注册商标。 隐私政策 & 条款. 在伦敦建立了爱情。