API を使用する

Communications Mining API へようこそ。 私たちは、APIを予測可能で使いやすく、簡単に統合できるよう努めています。 改善のためにできることがある場合、またはバグや予期しない動作が発生した場合は、 サポート にご連絡いただければ、できるだけ早くご連絡いたします。

利用可能なすべてのエンドポイントについては、 API リファレンスをご覧ください。 APIチュートリアルもあります。

API エンドポイント

すべての API 要求は、JSON オブジェクトとして Communications Mining の テナント エンドポイント に HTTPS 経由で送信されます。

UiPath を介してオンボードされたテナント

https://cloud.uipath.com/<my_uipath_organisation>/<my_uipath_tenant>/reinfer_/api/...

Communications Mining を介してオンボードされたテナント:

https://<mydomain>.reinfer.io/api/...

重要:

開発環境と運用環境

Communications Mining では、別々のテナントを持つか、同じテナント内の別々のプロジェクトに配置することによって、開発データと運用データとワークフローを分離できます。 いずれの場合も、データ アクセスは個別に許可されます (開発者が開発データへの管理者アクセス権を持ち、運用環境をより厳密に制御できるようにするため)。 別々のテナントを使用する場合、API エンドポイントは開発データと運用データごとに異なります。同じテナントで別々のプロジェクトを使用している場合は、その単一のテナントのエンドポイントが両方に使用されます。

認証

すべての API 要求には、要求を行うユーザーを識別するための認証が必要です。 認証はアクセス トークンによって提供されます。 開発者アクセス トークンは、[アカウントの管理] ページから取得できます。

注:

一度にアクティブにできる API トークンは 1 つだけです。 新しいトークンを生成すると、前のトークンは無効になります。

実行するすべての API 呼び出しに対して、次の HTTP ヘッダーを含める必要があります。 $REINFER_TOKEN は Communications Mining の API トークンです。

Authorization: Bearer $REINFER_TOKEN

API リファレンスの bash の例では、トークンが環境変数に保存されていることを前提としています。API リファレンスの Python と Node の例では、トークンがローカル変数に格納されていることを前提としています。REINFER_TOKEN、選択した構成ソリューションを介して。

• bash

  curl -X GET 'https://<my_api_endpoint>/api/...' \
      -H "Authorization: Bearer $REINFER_TOKEN"

• ノード

  const request = require("request");
  
  request.get(
    {
      url: "https://<my_api_endpoint>/api/...",
      headers: {
        Authorization: "Bearer " + process.env.REINFER_TOKEN,
      },
    },
    function (error, response, json) {
      // digest response
      console.log(JSON.stringify(json, null, 2));
    }
  );

• Python

  import json
  import os
  
  import requests
  
  response = requests.get(
      "https://<my_api_endpoint>/api/...",
      headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
  )
  
  print(json.dumps(response.json(), indent=2, sort_keys=True))

• レスポンス

  {
    "status": "ok"
  }

権限

API リファレンスの各 API エンドポイントには、必要なアクセス許可が一覧表示されます。[アカウントの管理] ページに移動して、自分が持っている権限を確認できます。 このページには、各プロジェクトでアクセスできる プロジェクト と 権限 が表示されます。

Error

従来のHTTP応答コードを使用して、APIリクエストの成功または失敗を示します。 一般に、 2xx 範囲のコードは成功を示し、 4xx 範囲のコードは指定された要求に起因するエラーを示し、 5xx 範囲のコードは Communications Mining プラットフォームに問題があることを示します。

また、error を要求すると、status 値が okではなく error の本文と、エラーを説明するエラー メッセージが返されます。

• bash

  curl -X GET 'https://<my_api_endpoint>/api/v1/nonexistent_page' \
      -H "Authorization: Bearer $REINFER_TOKEN"

• ノード

  const request = require("request");
  
  request.get(
    {
      url: "https://<my_api_endpoint>/api/v1/nonexistent_page",
      headers: {
        Authorization: "Bearer " + process.env.REINFER_TOKEN,
      },
    },
    function (error, response, json) {
      // digest response
      console.log(JSON.stringify(json, null, 2));
    }
  );

• Python

  import json
  import os
  
  import requests
  
  response = requests.get(
      "https://<my_api_endpoint>/api/v1/nonexistent_page",
      headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
  )
  
  print(json.dumps(response.json(), indent=2, sort_keys=True))

• レスポンス

  {
    "message": "404 Not Found",
    "status": "error"
  }

ネットワークの問題により、要求が Communications Mining に届く前に要求が失敗する可能性があります。 このような場合、受信する応答は、上記の Communications Mining のエラー応答とは異なるものになります。

パフォーマンスのタイミング

Server-Timing HTTP ヘッダーを使用して、API への要求が処理されるまでにかかる時間を通信します。1 つのメトリック totalが含まれており、これを使用して、ネットワーク要求の遅延なしにプラットフォームが要求を処理するのにかかった時間を測定することができます。

応答に表示されるヘッダーの例:

Server-Timing: total;dur=37.7

Server-Timing 値は常にミリ秒単位であるため、この場合、このヘッダー値を含む API リクエストが UiPath のプラットフォームで処理されるまでに 37.7 ミリ秒かかりました。