ricloud API FAQ
ここでは、ricloudで最もよく寄せられる質問をまとめました。
- ricloudとは何ですか?
- どうすればサポートを受けることができますか?
- サービスステータスとメンテナンスノートはどこで確認できますか?
- ricloud統合に最適な言語はどれですか?
- ricloud APIはどこでホストされていますか?
- iCloudアカウントのロックを最小限に抑える
- ricloudを使用する際のベストプラクティスは何ですか?
- ricloud APIはフィードやファイルのデータを保存しますか?
- 試用キーにはどのような制限が設定されていますか?
- データタイプxyzのデータが表示されないのはなぜですか?
ricloudとは何ですか?
ricloudは、ReincubateのCloud Data APIの名前です。このAPIにより、ユーザーはWi-Fi、USB、またはiCloud接続を介してiOSデバイスのデータに簡単にアクセスできます。
どうすればサポートを受けることができますか?
クライアントサポートはent-support@reincubate.comに電子メールでおよびプライベートSlack統合チャンネルを通して利用可能です。クライアントはサポートチームに連絡して統合チャネルの設定を手配することができます。
サービスステータスとメンテナンスノートはどこで確認できますか?
status.reincubate.comにステータスページを保持しています。ステータスページでは、ユーザーが更新をサブスクライブできます。更新は、計画または緊急のメンテナンスのために送信されます。
ricloud統合に最適な言語はどれですか?
Reincubateエンジニアリングチームは主にPythonを使用しています。その結果、最も洗練されたサンプルクライアント実装はPythonで構築されていますが、言語を使用する理由はありません。このAPIは、.NET / C#、PHP、Python、Java、およびJavaScript / Node.jsを実行しているクライアントによって使用されます。
ricloud APIはどこでホストされていますか?
ricloud APIのインフラストラクチャは、Google Cloud Platform、Amazon Web Services、Microsoft Azureなど、米国、EU、カナダの多くのプロバイダーによってホストされています。私たちは多くの北米のクライアントをGCPでホストしており、私たちがホストしているのと同じリージョンに一致するバケットを選択する場合、クライアントの帯域幅コストを削減できます。
信頼できる高帯域幅のアクセスを確保するために、クライアントはティア1ピアリングのホスティングパートナーを使用することをお勧めします。
iCloudアカウントのロックを最小限に抑える
アップルは、大規模で動的な一連の基準に基づいて、 iCloudアカウントをさまざまな頻度でロックします。概して、これらは3つのカテゴリに分類されます。
- ある技術が通信する方法
- 通信に使用されるインフラストラクチャの性質
- そのテクノロジーが伝達するリズム、パターン、そして周波数
ricloud APIは、3つすべての進化に対応します。 1つ目はAPIの背後にある独自のコードによって処理され、2つ目はReincubateが維持するかなり複雑なインフラストラクチャスタックによって処理されます。ただし、APIを直接制御する場合、クライアントは#3を大規模に、または定期的なポーリングを必要とするユースケースで管理するのに苦労する場合があります。
ricloudスケジューリングサービスは、クライアントのためにこれを管理するように設計されており、これらのユースケースの直接アクセスよりも推奨されます。
ricloudを使用する際のベストプラクティスは何ですか?
ricloud APIを最大限に活用するためのベストプラクティスがいくつかあります。
- このドキュメントを利用してください。よくある質問の多くはこれらの資料で回答されており、文書は定期的に更新されています。
- APIステータスページを使用して、計画的または緊急のAPIメンテナンスに関する更新を申し込むことができます。
- Slack統合チャネルを利用するクライアントは、早く稼働する傾向があります。
- オープンソースクライアントは、 ricloudサービスとの統合の完全な例を提供します。これを調べる(またはそこからコードを再利用する)と、統合中に多くの作業を節約できます。
- セキュリティとプライバシーのベストプラクティスに従い、エンドユーザーの資格情報を保存しないでください。代わりに、トークン化システムを使用してください。
- タスクの送信や結果のエンドポイントをリクエストにハードコーディングしないでください。それらは同じ値を取ることが多いのですが、APIはそれらを時々変えることがあります。
- 必要以上のタスクを生成しないでください。たとえば、バックアップ更新のポーリングは1日に数回以上不要であり、このための正確なスケジュールを考案するために多くのことを行うことができます。 APIは、多数のタスクを完了し、短時間で多くのデータを生成することができます。
- Reincubateは、アカウントに最初にアクセスしたときにアカウントの所有者に直接連絡してから、継続的に連絡を取って、クライアントの行動が確実に通知されるようにすることをお勧めします。詳細についてはプライバシーの強化をご覧ください。
ricloud APIはフィードやファイルのデータを保存しますか?
いいえ。フィードとファイルのデータはクライアントバケットにストリーミングされ、RIスタックには保持されません。
場合によっては、APIが一部のメタデータを永続化します。特に、スケジューラがメタデータのローリングウィンドウを保持して、正確なポーリングウィンドウを計算するのに役立ちます。
試用キーにはどのような制限が設定されていますか?
試用キーの制限は、キーの性質によって異なります。それらは以下によって制限されるかもしれません:
- キーを介してアクセス可能なデバイスまたはアカウントの数
- 2FA / 2SV以外のアカウントのサポート(例:コンプライアンス上の理由から、トライアルユーザーが2FA以外のアカウントにアクセスできないようにすることができます)
データタイプxyzのデータが表示されないのはなぜですか?
エラーではなくricloudからの空の応答が表示される場合は、データソースが空であったことを意味します。データが利用可能で、ricloudが取得できる状態になっていることを確認するには、以下の手順を試してください。
データタイプの関連設定がオンになっていることを確認してください。
- ソースがiOSデバイスのバックアップであるデータタイプの場合は、
Settings > [user name] > iCloud > iCloud Backup > iCloud Backup
でiCloudバックアップをオンにし、デバイスが少なくとも1回バックアップされていることを確認します。前述の画面で[Back Up Now
バックアップ]ボタンを押すと、バックアップを手動で起動できます。 - リアルタイムおよびニアタイムデータタイプの場合、設定は、データをiCloudと同期するサービスに固有の傾向があります。たとえば、
Settings > [user name] > iCloud > Find My iPhone > Find My iPhone
iPhoneを探す]に関連付けられている設定は、Settings > [user name] > iCloud > Find My iPhone > Find My iPhone
iPhoneを探すSettings > [user name] > iCloud > Find My iPhone > Find My iPhone
ます。 関連する設定は、サービスのドキュメントで他のデータ型プロパティと一緒にリストされています。
- ソースがiOSデバイスのバックアップであるデータタイプの場合は、
デバイスがデータを同期する機会を得ていることを確認してください。
- iCloudバックアップベースのフィードの場合、自動iCloudバックアップを開始するにはデバイスをプラグインしてロックする必要があります。手動バックアップはいつでも起動できます。
- リアルタイムおよびニアタイムデータタイプの場合、同期トリガーはサービス設計によって異なります。一般に、遅い同期プロセスの実行には4〜6時間かかることがあります。