概述(v2)

更新

介绍

有四种服务包含并用于与ricloud API交互: asmasterasapiaschannelasstore 。客户端通常只与这些服务中的两个进行交互,而不是全部四个。

API可以通过以下两种方式之一进行控制:使用asmasterasapi 。从aschannel (用于实时检索数据的firehose流)或asstore (用于批量检索数据的桶)接收结果。

零件结果交付最适合令牌管理
asmaster aschannel 定期检索数据继续培养
ASAPI aschannelasstore 不经常的低容量访问推迟到客户端

实时数据访问

使用asmaster ,客户注册兴趣帐户或设备,然后在可用时实时接收上的新数据。 asmaster有效是ASAPI智能控制器,从而进一步降低客户的需要了解数据存储和检索的机制,并且可以更快速地提供数据和安全,然后客户可以用自己的实现对ASAPI。

根据基础数据类型和源, asmaster可以在内部订阅数据的上游数据以进行实时更新,也可以使用智能预测调度程序来管理轮询。

近期和批量数据访问

使用asapi ,客户端可以根据需要从帐户或设备请求数据,然后在上准备好数据或轮询存储桶时接收数据。

概念与服务

ricloud API围绕四个关键概念建模: 操作任务服务帐户

动作是API执行的基本工作单元;每个操作都与服务相关联。例如,可以执行fetch_data 操作 ,这是icloud 服务的一部分。每个操作都是针对一个帐户执行的。帐户代表从中检索的服务数据的最终用户帐户。如果客户已注册帐户,则客户可以访问该帐户 。每个操作实例都被描述为一个任务 ,并分配了一个task_id

App stream master( asmaster

asmaster是API的订阅控制机制。它使用户能够:

  • 发现他们有权使用的服务操作和终端
  • 注册,注销并了解帐户
  • 订阅并取消订阅来自帐户的自动数据Feed

使用这种方法, asmaster会自动为asapi生成任务 ,并从aschannel获取结果数据。

asmaster的详细文档可在订购asmaster数据时获得

应用流API( asapi

asapi是API的异步控制机制。它使用户能够:

  • 发现他们有权使用的服务操作和终端
  • 注册,注销并了解帐户
  • 提交异步任务
  • 查询任务状态

完成后,可以从aschannelasstore获取任务中的数据,具体取决于客户端的用例。

对于ASAPI详细的文档,请与ASAPI请求数据

应用流信道( aschannel

aschannel是一个流端点,允许客户端在生成时实时检索每个提交任务的结果。

通过打开与aschannel端点的连接来检索结果。

  • 结果以JSON格式流式传输
  • 一旦它们可用,就可以从服务中检索它们
  • 渠道是无国籍的;如果客户端错过了结果的传输,则在没有重新提交任务的情况下无法重播

对于aschannel详细的文档,请与aschannel流数据

应用程序流存储( asstore

asstore是一个有时间限制的结果存储,它允许客户端在它们可用时检索已提交任务的结果。

  • 结果在过期和删除之前存储一段有限的时间
  • 结果只能下载一次;它被删除一次消费

对于asstore详细的文档,请与asstore下载数据

使用的标准

在整个ricloud及其文档中,使用了以下标准:

  • 该API一贯使用日期的ISO-8601格式,在UTC时区。例如,12月24日将表示为2014-12-24 17:30:00.000000
  • ricloud组件返回的结构化数据总是使用JSON 。这通常由响应中的application/json内容类型指示。
  • 本文档中的命令示例使用curl命令以bash格式给出。

我们能帮你什么吗?

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

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

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

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

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