概要(v2)

更新しました

前書き

asicasterasapiaschannel 、およびasstoreの 4つのサービスがあり、それらを使用して、 これらの APIとやり取りします。クライアントは通常、4つすべてではなく2つのサービスとのみ対話します。

APIは、 asmasterまたはasapiの 2つの方法のいずれかで制御できます。結果はaschannel (データのリアルタイム検索用のfirehoseストリーム)またはasstore (データのバッチ検索用のバケット)から受信されます。

成分結果配信に最適トークン管理
管理者 アスチャンネル 定期的なデータ検索再インキュベートする
アサピ aschannelまたはasstore まれな少量アクセスクライアントに延期

リアルタイムデータアクセス

asmasterを使用すると 、クライアントはインタレストアカウントまたはデバイスを登録して、新しいデータが利用可能になったときにリアルタイムでストリームで受信します。 asmasterは事実上asapi用のスマートコントローラであり 、これはクライアントがデータの保存と検索の仕組みを理解する必要性をさらに減らし、 asapiに対してクライアントが独自に実装するよりも早くそして安全にデータを提供することができます。

基礎となるデータ型とソースに応じて、 asmasterはリアルタイムの更新のためにデータのアップストリームフィードを内部的に購読するか、またはスマートな予測スケジューラを使用してポーリングを管理します。

ニアタイム&バッチデータアクセス

asapiを使用すると 、クライアントは必要に応じてアカウントまたはデバイスからデータを要求し、 ストリームの準備ができたらまたはバケットをポーリングすることによってデータを受信します。

概念とサービス

ricloud APIは、 アクションタスクサービス 、およびアカウントという 4つの主要概念に基づいてモデル化されています

アクションはAPIによって実行される基本的な作業単位です。各アクションサービスに関連付けられています 。例えば、1は実行することができfetch_data アクションの一部icloud サービスを 。すべてのアクションアカウントに対して実行されます 。アカウントは、どのサービスデータが取得されているかに関するエンドユーザーアカウントを表します。 アカウントは、そのクライアントによって登録されている場合、そのクライアントにアクセス可能です。アクションの各インスタンスはタスクとして記述され、 task_id割り当てられます。

アプリストリームマスター( asmaster

asmasterはAPIのサブスクリプション制御メカニズムです。これにより、ユーザーは次のことが可能になります。

  • 使用が許可されているサービスアクション 、およびエンドポイントを発見する
  • アカウントの登録、登録解除、および学習
  • アカウントからのデータの自動フィードの購読と購読解除

このアプローチでは、asmasterが自動的ASAPIタスク 、およびaschannelから得られた結果データを生成します。

asmasterの詳細なドキュメントはasmaster でデータを購読するときに利用可能です。

アプリストリームAPI( asapi

asapiはAPIの非同期制御メカニズムです。これにより、ユーザーは次のことが可能になります。

  • 使用が許可されているサービスアクション 、およびエンドポイントを発見する
  • アカウントの登録、登録解除、および学習
  • 非同期タスクを送信する
  • タスクの状況を照会する

完了すると、 タスクのデータは、クライアントのユースケースに応じて、 aschannelまたはasstoreから取得できます。

asapiの詳細な資料は、 asapiに データを要求するときに入手できます。

アプリストリームチャンネル( aschannel

aschannelはストリーミングエンドポイントです。これにより、クライアントは送信された各タスクの結果を生成時にリアルタイムで取得できます。

結果は、 aschannelエンドポイントへの接続を開くことによって取得されます。

  • 結果はJSON形式でストリーミングされます
  • それらが利用可能になるとすぐにそれらはサービスから検索することができます
  • チャネルはステートレスです。クライアントが結果の送信を見逃した場合は、 タスクを再送信しないと再生できません。

aschannelの詳細なドキュメンテーションは、 aschannel を使っデータのストリーミングで入手できます。

アプリストリームストレージ( asstore

asstoreは時間制限のある結果ストアで、クライアントは送信されたタスクの結果を利用可能になったときに取得できます。

  • 結果は期限切れになり削除される前に限られた期間保存されます
  • 結果は一度だけダウンロードできます。一度消費されると削除されます

asstoreの詳細な資料は、 asstoreデータをダウンロードするときに入手できます。

使用されている規格

ricloudとそのドキュメントを通して、以下の標準が使われています。

  • APIは、 UTCタイムゾーンのISO-8601形式の日付を一貫して使用します。たとえば、12月24日は2014-12-24 17:30:00.000000と表現されます。
  • ricloudのコンポーネントから返される構造化データは常にJSONを使用します 。これは常にレスポンスのapplication/json content-typeによって示されapplication/json
  • このドキュメントのコマンド例は、 curlコマンドを使用してbash形式で示されています。

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

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

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

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

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

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