Webサービスの概要

Webサービスの概要

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Alert

早期アクセス

Webサービスはすべてのユーザーに対して有効になっているわけではありません。お試しになりたい場合は、早期アクセスについてサポートチームにメールでお問い合わせください。
Webサービスは、さまざまなアプリケーションが標準プロトコルを使用してネットワーク経由で相互に通信できるようにし、データ交換やリモート操作の実行を可能にします。Qntrlプラットフォームでは、次の2種類のWebサービスをサポートしています。
  1. インバウンドWebサービス：これらのサービスにより、システムは外部システムからの要求を受信できます。
    • インバウンドREST Webサービス
    • インバウンドSOAP Webサービス
  2. アウトバウンドWebサービス：これらのサービスにより、システムは外部システムに要求を送信できます。
    1. アウトバウンドREST Webサービス
    2. アウトバウンドSOAP Webサービス
 

REST Webサービス 

REST（Representational State Transfer）は、Web APIの構築に広く使用される軽量で柔軟なアーキテクチャです。RESTfulサービスは、GET、POST、PUT、DELETEなどの標準HTTPメソッドを使用して通信し、通常はJSONまたはXMLなどの形式でデータを交換します。

主な機能

  • ステートレス：クライアントからサーバーへの各要求には、その要求の処理に必要なすべての情報を含める必要があります。
  • リソースベース：やり取りはリソース（データオブジェクト）を中心に行われ、各リソースは一意のURLで識別されます。
  • 軽量：オーバーヘッドが少なく、連携が容易で、パフォーマンスも向上します。
Info

  • モバイルアプリケーションやWebアプリケーションに適しています。

  • 高速で拡張性のある通信が必要な最新のAPIでよく使用されます。

  

SOAP Webサービス

SOAP（Simple Object Access Protocol）は、Webサービスで構造化された情報を交換するために使用されるXMLベースのプロトコルです。次の特定のガイドラインに従います。
  • 要求と応答の形式：どちらもXMLである必要があります。
  • HTTPメソッド：要求はPOSTメソッドで送信する必要があります。
  • 要求ペイロード：クエリーパラメーターやヘッダーではなく、本文に含める必要があります。要求メッセージは特定の構造に従い、操作はXML要求タグ内で定義されます。

主な機能 

  • 厳格な標準：サービス構造の説明にはWSDL（Webサービス説明言語）を使用します。
  • 高い安全性と信頼性：WS-Security、トランザクション、メッセージレベルの暗号化などの高度な機能をサポートします。
  • プラットフォームおよび言語に依存しない。
Info

  • 企業環境でセキュリティ、トランザクションの整合性、または正式な契約が必要な場合に適しています。

  • レガシーシステムや大規模なビジネスアプリケーションとの連携でよく使用されます。

 

SOAP WebサービスにおけるWSDL  

WSDL（Webサービス説明言語）は、SOAP Webサービスの構造を記述するXMLベースの定義です。サービスの操作、入出力データ型、通信プロトコル、エンドポイントの場所を示します。QntrlのインバウンドおよびアウトバウンドSOAPサービスでは、システム間の通信を定義し円滑にするためにWSDLを使用します。
  • インバウンドSOAPサービス：QntrlでインバウンドSOAPサービスを作成すると、WSDLファイルが自動的に生成されます。このWSDLはサービス契約として機能し、利用可能な操作、想定される要求形式、応答構造を定義します。外部システムはこのURLにアクセスしてWSDLをダウンロードし、SOAPクライアントを設定してWebサービスと連携できます。
  • アウトバウンドSOAPサービス：アウトバウンドSOAPサービスの場合、外部サービスのWSDLファイルを指定する必要があります。Qntrlはこのファイルを使用して、外部サービスでサポートされている操作を把握し、それに応じて送信SOAP要求の形式を整えます。
 

インバウンドAPIトラフィックの監視   

「監視」セクションでは、受信APIリクエストをグラフ形式で表示し、Inbound RESTサービスとInbound SOAPサービスのパフォーマンスを追跡できます。すべてのインバウンドAPIリクエストは自動的に記録され、監視チャートに反映されます。
Notes
監視データは、Inbound RESTサービスまたはInbound SOAPサービスがAPIリクエストの受信を開始した後にのみ利用できます。

監視チャートの表示 

  1. Qntrlにログインします。
  2. ［Webサービス］に移動し、必要なInbound RESTまたはInbound SOAP設定を選択します。
  3. ［監視］タブを開きます。
  4. ［時間］フィルターを使用して期間を選択します。事前定義された期間を選択するか、カスタムの日付と時間の範囲を指定できます。
監視チャートは、選択した期間に基づいて更新されます。



利用可能な指標   

選択した期間について、次の指標が表示されます。

  • 合計件数：受信したAPIリクエストの合計数。

  • 失敗したリクエスト：失敗したAPIリクエストの合計数。

  • 5xxエラー：サーバー側エラーのリクエスト数（HTTP 5xxレスポンス）。

  • 低速リクエスト：レスポンス時間のしきい値（> 1秒）を超えたリクエスト。




次へ：