来源

更新

源表示来自服务的数据源。例如,iCloud帐户是iCloud服务的来源。

源可以具有子源,这些子源仅公开父源的特定部分。这方面的一个示例是iCloud备份子源,当以数据请求为目标时,它将仅返回从该特定备份中检索到的数据。

属性

名称类型描述
id 来源ID 资源标识符。
resource 字符串,总是source 资源类型说明符。
user 用户身份与此源关联的用户。
type 取决于支持服务 。例如,iCloud具有icloud_account 源类型
identifier 在其支持服务范围内的源的唯一标识符。
parent 可选的源ID 如果源是另一个的孩子,则填充。
children 可选的源资源列表 的任何子源。
state 其中之一: unvalidated ,已activedeactivated ,已blocked ,已locked
date_created 约会时间资源创建时。

类型

当前支持的类型包括:

  • icloud.account ,iCloud服务的主要来源。
  • icloud.backup ,一个孩子源icloud.account
  • rirelay.instance ,是rirelay服务的主要来源。对应于Reincubate Relay应用程序的实例。
  • rirelay.source ,一个孩子源rirelay.instance 。对应于父级Reincubate Relay应用程序有权访问的设备。

识别码

源的identifier属性的值在其服务中唯一地对其进行标识。对于iCloud帐户,这将是用户名。对于Reincubate Relay应用程序实例,它将是实例ID。

如果源是子源,则此字段将指向其父源对象。此层次结构中的顶级源称为主要源。

无法通过API直接创建子源,但在创建适当的轮询时,API会自动创建子源。例如,一旦为icloud.account源初始化会话,就可以创建info类型Poll,它将检索有关该帐户的信息,包括链接到该帐户的现有iCloud备份的任何信息,并为这些创建相应的子源。 。然后可以直接定位子源以通过单独的民意调查来检索数据。

状态

unvalidated
从未针对此源成功创建会话,因此API无法判断它是否是有效源。
active
源已经过验证并可以使用。
deactivated
拥有组织禁止访问来源。
blocked
API管理员禁止访问源。
locked
外部服务暂时限制对源的访问。

检索GET /sources/{source ID}

使用cURL

curl https://ricloud-api.reincubate.com/sources/<source ID> \
  -H 'Authorization: Token <your key_token>'

使用ricloud-py

import ricloud

source = ricloud.Source.create(<source ID>)

列出GET /sources

名称类型描述
organisation 超级,组织ID 使API管理员按组织过滤。
user 用户身份按关联用户过滤。
type 按源类型过滤。
identifier 按源标识符过滤。
state 按源状态过滤。
date_created 日期时间过滤器按资源创建日期过滤。

使用cURL

curl https://ricloud-api.reincubate.com/sources \
  -H 'Authorization: Token <your key_token>'

使用ricloud-py

import ricloud

sources = ricloud.Source.list()

更新POST /sources/{source ID}

名称类型描述
state 更新源状态。

使用cURL

curl https://ricloud-api.reincubate.com/sources/<source ID> \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "state": "deactivated"
}'

使用ricloud-py

import ricloud

source = ricloud.Source.update_with_id(<source ID>, state='deactivated')

# OR

source = ricloud.Source.retrieve(<source ID>)

source.update(state='deactivated')

我们能帮你什么吗?

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

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

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

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

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