IBM MaaS360 API リファレンス

MaaS360® では、管理者は IBM® MaaS360 Portal ユーザー・インターフェースからWebサービスAPIにアクセスできます。 MaaS360 アカウントでこの機能を有効にするには、IBM サポートにお問い合わせください。

Web サービスに関する API リファレンスには、実装の注意、API を実行するための必須属性、アクセス制御の詳細、応答クラスとモデルの例、パラメーターの詳細などの情報が含まれています。

Web サービス API アクセシビリティー権限

MaaS360には、IBMMaaS360ポータルからWebサービスAPIにアクセスするための2種類のアクセシビリティ権限が含まれています。 サービス管理者役割を持つ管理者アカウントに適切な Web サービス API アクセシビリティー権限を割り当てます。

  • 読み取りアクセス：管理者はIBM MaaS360 ポータルでウェブサービスAPIドキュメントを閲覧できます。 ビジネス管理者 (BU) アカウントには、読み取りアクセス権限が提供されます。
  • 管理者アクセス：管理者は、IBM MaaS360 ポータルで、WebサービスAPIドキュメントを閲覧し、サンプリングすることができます。 カスタマー管理者アカウントには、管理アクセス権限が提供されます。

管理者に割り当てられているアクセス権限のタイプに応じて、管理者アカウントの Web サービス API のアクセシビリティー・レベルは異なります。

IBM MaaS360 ポータルから Web サービス API を利用可能

適切なアクセシビリティ・ロールを持つ管理者は、IBM MaaS360 ポータルからWebサービスAPIにアクセスできます。 「セットアップ」 > 「Web サービス API」 に移動し、 「文書」 をクリックして、ポータルから Web サービス API を表示または実行します。

管理アクセス権限を持つ管理者アカウントは、Web サービス API を実行するための「試行 (Try it out)」オプションを使用できます。

注意: MaaS360 Web サービス API は、TLS バージョン 1.1 以降をサポートします。

IBM MaaS360 ポータルからのWebサービスAPI実行手順

  1. 「セットアップ」 > 「Web サービス API」から、 「文書」をクリックします。
  2. 「認証」API に移動し、カスタマーの「請求書 ID」および「本文 (body)」パラメーターを入力します。
  3. 「試行 (Try it out)」をクリックして、認証トークンを生成します。
    注: 生成された認証トークンを応答本文にコピーして、 MaaS360 Web サービス API を試します。 トークンを生成した後で、トークンは 60 分間有効です。
  4. IBM MaaS360 Portal内のMaaS360 WebサービスAPIにアクセスし、以下の詳細を入力してください：
    • API を試行するために必要なすべての必須パラメーター (請求書 ID など)。
    • ステップ 3 で生成した認証トークン。
      注意: 認証トークンの値を引用符で囲んで入力し、プレフィックス MaaS token= を使用する必要があります。 例えば、MaaS token="xxxxxx"です。
  5. 「試行 (Try it out)」をクリックして、Web サービス APIを試行します。 Web サービス API の要求 URL、応答本文、応答コード、および応答ヘッダーが表示されます。
    注意: 応答コンテンツ・タイプは、デフォルトでは application/XML です。 応答コンテンツ・タイプが JSON 形式である必要がある場合は、application/json を選択します。