概观

更新

这是Reincubate的第三版ricloud API的文档。 API为用户提供了一种机制,可以通过asrelay轻松访问各种数据源的应用数据,包括Apple的iCloud和本地iTunes备份。

有关产品信息,请参阅ricloud产品页面

关键术语

在深入了解入门部分之前,熟悉将在整个过程中使用的一些术语和概念是有帮助的。

服务

服务描述了通过API可用的数据源集合。这包括第三方服务,如iCloud或Reincubate产品,如asrelay

不同的服务对API上的某些资源有不同的要求,并且会改变API对象的整个生命周期。例如,为iCloud服务创建会话所需的有效负载与asrelay服务所需的有效负载不同。

资源

这些是服务中的特定数据源。 iCloud帐户是iCloud服务的主要来源,而asrelay客户端实例是asrelay服务的主要来源。

在许多情况下,服务将具有可以单独定向的源的层次结构。例如,iCloud服务具有帐户来源和设备来源。

用户

用户应始终代表请求数据的最终用户。在许多情况下,这将是您的应用程序的用户。

会议

会话表示对特定源的访问,并且需要通过API从源检索任何信息或数据。

创建会话相当于“登录”到iCloud帐户或“与asrelay客户端实例配对”。

API将通过任务异步执行会话初始化过程。这意味着创建会话的调用将立即返回,但在初始化完成之前,会话将无法使用。

轮询

民意调查是用户通过API请求数据的方式。要设置轮询,需要针对目标源的活动会话。

所有民意调查都通过一项或多项任务异步处理,结果将发布到组织中配置的云存储分区。

任务

这些是API执行的基础工作。创建会话时,它还会创建一个任务,以便对外部服务执行任何初始化。创建轮询时,它将创建至少一个任务来执行数据检索工作。

关键概念

资源

API围绕API资源引用中描述的一组资源进行组织。通过这些资源,API的客户端能够:自定义其API配置,初始化对数据源的访问,以及从这些源检索数据。

异步处理

API依赖于异步操作来设置针对第三方服务和数据处理的会话。这使其能够在负责任地与外部服务交互的同时管理大量数据需求。它还提供了额外的灵活性,以应对响应时间的波动或来自第三方的服务降级。

存储桶发布

从API请求的数据将直接发布到Google云端存储或Amazon S3上的客户端存储桶中。这有助于最大限度地减少与扩展数据交付相关的问题,并且还可以加快数据检索速度,因为发布不太可能成为瓶颈。

Webhook通知

通过webhook机制处理异步操作完成的通知,从而通过标准HTTP请求将事件发送到客户端的服务器。这些事件包含有关在客户端桶中查找请求数据的位置的信息,允许客户端决定何时以及如何使用它。

我们能帮你什么吗?

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

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

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

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

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

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

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