最佳实践(v2)

更新

一般

有许多最佳实践可用于充分利用Reincubate Cloud Data API。

  • 使用此文档。这些材料中回答了许多常见问题,并定期更新文档。
  • API状态页面可用于注册任何计划或紧急API维护的更新。
  • 利用Slack集成渠道的客户往往会更早上线。
  • 开源客户端提供了与ricloud服务集成的完整示例,并且检查(或重用代码)可以在集成期间节省大量工作。
  • 在测试和集成时充分利用模拟数据 ,但请记住,实际数据访问速度可能较慢。
  • 遵循安全和隐私最佳实践,并且不存储最终用户凭据。相反,使用标记化系统
  • 不要在请求中对任务提交或结果端点进行硬编码:虽然它们通常可能采用相同的值,但API可能会不时地对其进行更改。
  • 不要生成超出必要的任务:例如,每天不必多次轮询备份更新,并且可以做很多事情来为此设计准确的计划。 API能够在很短的时间内完成大量任务并生成大量数据,特别是在使用aschannel时 ,客户应该警惕请求超出他们可以轻松消费的数量。
  • Reincubate认为最佳做法是在首次访问帐户时直接联系帐户持有人,然后持续联系以确保他们了解客户活动。有关详细信息,请参阅增强隐私
  • 有定期轮询帐户要求的客户应该评估asmaster而不是asapi

🚨支持和服务状态

服务状态和维护通知

Reincubate在status.reincubate.com上维护状态页面。状态页面允许用户订阅更新。发送更新以进行任何计划或紧急维护。

直接支持

客户支持可通过电子邮件ent-support@reincubate.com和私人Slack集成渠道获得。客户可以联系支持团队以安排集成渠道的设置。

报告问题

遇到API问题时,如果向支持团队通知问题响应中收到的X-RI-Build HTTP标头,则可以加快解决速度。 X-RI-Build HTTP标头如下所示:

X-RI-Build: 1.0-pre-ios9-395-g126226b; nj-api-7

在分类问题报告时,支持工程师将总是要求提供可用于演示问题复制和服务器响应的curl命令。

🔓最大限度地减少iCloud帐户锁定

Apple基于大量动态标准锁定具有各种频率的iCloud帐户 。从广义上讲,这些分为三类:

  1. 一种技术交流的方式
  2. 用于通信的基础设施的性质
  3. 技术传达的节奏,模式和频率

Reincubate的Cloud Data API会随着它们的发展而解决这三个问题。第一个是由API背后的专有代码处理的,第二个是由Reincubate维护的实质和复杂的基础架构堆栈处理的。但是,当使用asapi直接控制API时,客户可能很难在规模或需要定期轮询的用例中管理#3。

使用asapi进行轻微或一次性使用不太可能导致锁定,但如果管理不当,可能会进行常规访问。 asmaster服务旨在为客户端管理此服务,建议使用这些用例的直接asapi访问。

🎁模拟集成和测试数据

Apple iCloud服务示例数据

有关Apple iCloud服务数据的丰富模拟帐户,请访问john.appleseed@reincubate.com帐户,该帐户可通过密码joshua访问。提供数据是为了快速测试与API的集成。

访问此帐户不可计费,样本数据直接从Reincubate的服务器传送,大大加快了响应时间。

常问问题

API是否存储任何Feed或文件数据?

不,当与aschannel一起使用时,因为源和文件数据流式传输到客户端而不是持久存储在RI堆栈中。使用asstore时 ,信息将存储在存储桶中,直到检索到为止。但是,几乎所有用例都推荐使用该通道。

在某些情况下,API会保留一些元数据,最明显的是asmaster的调度程序保留元数据的滚动窗口,以帮助计算准确的轮询窗口。

如何向asmaster请求提要和附件?

没有必要。订阅帐户或设备后,数据将在准备就绪时通过aschannel自动提供。

我如何告诉asmaster给我更多或更少的模块?

无需以编程方式执行任何操作。客户端的密钥配置包括他们可以访问哪些模块的数据,以及流数据时将使用的所有模块。配置团队更新客户端密钥后,新模块集将反映在Feed中。

asmaster投票的频率是多少

asmaster的调度机制努力提供数据服从两个目标:不超过给定服务的最佳实践轮询频率,并提供尽可能接近的数据。调度程序将始终优先考虑不损害帐户或违反最佳做法而不是获取新数据。

使用实时数据进行操作时,这可能意味着数据以实时,近时或批处理频率提供。对于批处理数据,调度程序本身将以批处理模式运行。

频率选择背后的规则集是动态的。

试用密钥设置了什么限制?

试用密钥限制可以根据密钥的性质而变化。他们可能受以下因素限制:

  • 可通过密钥访问的设备或帐户数
  • 支持非2FA / 2SV帐户(例如,出于合规性原因,可以阻止试用用户访问非2FA帐户)

API托管在哪里?

请参阅托管和连接中的注释。

为什么我没有看到数据类型xyz的任何数据?

如果您看到ricloud的空响应,而不是错误,则表示数据源为空。要确保数据可用并准备好检索ricloud ,请尝试下面列出的步骤。

  1. 确保已打开数据类型的关联设置

    • 对于源是iOS设备备份的数据类型,这意味着在Settings > [user name] > iCloud > iCloud Backup > iCloud Backup打开Settings > [user name] > iCloud > iCloud Backup > iCloud Backup ,并确保设备至少已备份一次。可以通过按上述屏幕上的Back Up Now按钮手动触发备份。
    • 对于实时和近时数据类型,设置往往更加特定于负责与iCloud同步数据的服务。例如,可以在Settings > [user name] > iCloud > Find My iPhone > Find My iPhone下找到与查找我的iPhone相关联的设置。 相关设置Feed模块部分中的其他数据类型属性一起列出。
  2. 确保设备有机会同步数据。

    • 对于基于iCloud备份的源,需要插入并锁定设备以开始自动iCloud备份。您仍然可以随时触发手动备份。
    • 对于实时和近时数据类型,同步触发器因服务设计而异。通常,一些较慢的同步进程可能需要大约4-6小时才能运行。

弃用

  • 截至2017年第一季度, 传统的ricloud 1.x可以被认为已被弃用,尽管它仍然得到了一个适配器的完全支持,该适配器将其流量重新整形并路由到asapi

我们能帮你什么吗?

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

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

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

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

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