ベストプラクティス(v2)

更新しました

全般

Reincubate Cloud Data APIを最大限に活用するために使用するためのベストプラクティスがいくつかあります。

  • このドキュメントを利用してください。よくある質問の多くはこれらの資料で回答されており、文書は定期的に更新されています。
  • APIステータスページを使用して、計画的または緊急のAPIメンテナンスに関する更新を申し込むことができます。
  • Slack統合チャネルを利用するクライアントは、早く稼働する傾向があります。
  • Open Sourceクライアントは、 ricloudサービスとの統合の完全な例を提供してます。そしてそれを調べること(またはそこからコードを再利用すること)は統合の間の多くの作業を節約することができます。
  • テストと統合の際にはモックデータを利用しますが、実際のデータアクセスは遅くなる可能性があることに注意してください。
  • セキュリティとプライバシーに関するベストプラクティスに従い、エンドユーザーの資格情報を保存しないでください。代わりに、 トークン化システムを使用してください
  • タスクの送信や結果のエンドポイントをリクエストにハードコーディングしないでください。それらは同じ値を取ることが多いのですが、APIはそれらを時々変えることがあります。
  • 必要以上のタスクを生成しないでください。たとえば、バックアップ更新のポーリングは1日に数回以上不要であり、そのための正確なスケジュールを立てるために多くのことを実行できます。 APIは、 短時間で大量のタスクを完了し、大量のデータを生成することができます。特にaschannelを使用する場合 、クライアントはすぐに消費できる以上の要求には慎重になる必要があります。
  • Reincubateは、アカウントに最初にアクセスしたときにアカウントの所有者に直接連絡してから、継続的に連絡を取って、クライアントの行動が確実に通知されるようにすることをお勧めします。詳細についてはプライバシーの強化をご覧ください。
  • 定期的にアカウントをポーリングする必要があるクライアントは、 asapiではなくasmasterを評価する必要があります。

?サポートとサービスの状況

サービス状況と保守通知

再インキュベーションは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コマンドとサーバーの応答を求めます。

i iCloudアカウントのロックを最小限に抑える

アップルは、大規模で動的な一連の基準に基づいて、 iCloudアカウントをさまざまな頻度でロックします。概して、これらは3つのカテゴリに分類されます。

  1. ある技術が通信する方法
  2. 通信に使用されるインフラストラクチャの性質
  3. そのテクノロジーが伝達するリズム、パターン、そして周波数

ReincubateのCloud Data APIは、3つすべてが進化するにつれて対処します。 1つ目はAPIの背後にある独自のコードによって処理され、2つ目はReincubateが維持する実質的で複雑なインフラストラクチャスタックによって処理されます。ただし、 asapiを使用してAPIを直接制御している場合、クライアントは大規模または定期的なポーリングを必要とするユースケースで#3の管理に苦労する可能性があります。

asapi軽い使用または1回限りの使用はロックにつながる可能性は低いですが、適切に管理されていない場合は通常のアクセスが行われる可能性があります。 asmasterサービスはクライアントのためにこれを管理するように設計されており、これらのユースケースのために直接asapiアクセスよりも推奨されています。

integration統合およびテスト用のモックデータ

Apple iCloudサービスのサンプルデータ

Apple iCloudサービスデータの豊富なモックアカウントが、パスワードjoshuaアクセス可能なjohn.appleseed@reincubate.comアカウントで提供されています。データは、APIとの統合を迅速にテストするために提供されています。

このアカウントへのアクセスは課金されず、サンプルデータはReincubateのサーバーから直接配信されるため、応答時間が大幅に短縮されます。

よくある質問

APIはフィードやファイルのデータを保存しますか?

いいえ、フィードとファイルのデータはクライアントにストリーミングされ、RIスタックに保持されないため、 aschannelと併用した場合は使用できません。 asstoreを使用すると 、情報は取得されるまでバケットに格納されます。ただし、このチャネルはほとんどすべてのユースケースに推奨されています。

場合によっては、APIは何らかのメタデータを保持します。最も顕著なのは、 asmasterのスケジューラが正確なポーリングウィンドウを計算するのを助けるためにローリングウィンドウのメタデータを保持する場合です。

asmaster使ってフィードや添付ファイルをリクエストするにはどうすればいいですか?

する必要はありません。アカウントまたはデバイスを購読すると、データは準備完了時にasチャンネルを介して自動的に提供されます。

どうやってasmasterにもっと多くの、またはもっと少ないモジュールを提供するように指示できますか?

プログラム的に何もする必要はありません。クライアントの重要な設定には、どのモジュールにアクセスできるかに関するデータが含まれ、データをストリーミングするときにはすべてのモジュールが使用されます。プロビジョニングチームがクライアントキーを更新すると、新しいモジュールセットがフィードに反映されます。

管理者はどのくらいの頻度でポーリングしますか?

asmasterのスケジューラメカニズムは2つの目的に従うデータを提供しようとします:与えられたサービスのためのベストプラクティスポーリング頻度を超えないこと、そしてそれが可能な限り利用可能にされるときにできるだけ近いデータを提供すること。スケジューラは、常に新しいデータを取得するよりも、アカウントに害を与えたりベストプラクティスに違反したりしないことを優先します。

リアルタイムデータで操作する場合、これはデータがリアルタイム、ニアタイムまたはバッチ頻度で提供されることを意味します。バッチデータでは、スケジューラ自体がバッチモードで動作します。

周波数選択の背後にあるルールセットは動的です。

トライアルキーにはどのような制限がありますか?

試用キーの制限は、キーの性質によって異なります。それらは以下によって制限されるかもしれません:

  • キーを介してアクセス可能なデバイスまたはアカウントの数
  • 2FA / 2SV以外のアカウントのサポート(例:コンプライアンス上の理由から、トライアルユーザーが2FA以外のアカウントにアクセスできないようにすることができます)

APIはどこでホストされていますか?

ホスティングと接続の注意を参照してください。

データ型xyzのデータが表示されないのはなぜですか?

エラーではなく、 ricloudから空の応答が表示された場合は、データソースが空だったことを意味します。データが利用可能であり、 ricloudが取得できるようにするには、以下の手順を試してください。

  1. データタイプの関連設定がオンになっていることを確認してください。

    • ソースがiOSデバイスのバックアップであるデータタイプの場合は、 Settings > [user name] > iCloud > iCloud Backup > iCloud BackupでiCloudバックアップをオンにし、デバイスが少なくとも1回バックアップされていることを確認します。前述の画面で[ Back Up Nowバックアップ]ボタンを押すと、バックアップを手動で起動できます。
    • リアルタイムおよびニアタイムデータタイプの場合、設定は、データをiCloudと同期させる役割を果たすサービスに固有のものになる傾向があります。たとえば、iPhoneの検索に関連する設定は、設定Settings > [user name] > iCloud > Find My iPhone > Find My iPhoneます。 関連付けられた設定は、 フィードモジュールセクションに他のデータ型プロパティと一緒に表示されます
  2. デバイスがデータを同期する機会を得ていることを確認してください。

    • iCloudバックアップベースのフィードの場合、自動iCloudバックアップを開始するにはデバイスをプラグインしてロックする必要があります。手動バックアップはいつでも起動できます。
    • リアルタイムおよびニアタイムデータタイプの場合、同期トリガーはサービス設計によって異なります。一般に、遅い同期プロセスの実行には4〜6時間かかることがあります。

廃止予定

  • 2017年第1四半期の時点で、 旧来のricloud 1.xは廃止予定と見なすことができますが、トラフィックを変形してasapiにルーティングするアダプタによって完全にサポートされています

どのように我々は助けることができます?

サポートチームがお手伝いします!

営業時間は月曜日から金曜日の午前9時から午後5時(GMT)です。 時間は現在 4:19 PM GMTです。

1営業日以内に、お返事を差し上げます。メールアドレスはこちら。

サポートセクションに移動 › エンタープライズチームに連絡する ›
私たちの素晴らしいサポートチーム

© 2008 - 2019 Reincubate Ltd. 無断複写・転載を禁じます。 イングランドとウェールズに登録 #5189175, VAT GB151788978. Reincubate®は登録商標です。 プライバシーと利用規約. マルチファクタ認証をお勧めします。 ロンドンで愛と建てられた。