機械翻訳について
  1. Sites管理用のSites ManagementREST APIのREST API
  2. APIを試す

APIを試す

Sites Management用のREST APIと統合する予定の開発者は、最初に、いくつかのリクエストを作成して試すことができます。 そのためには、curlコマンドライン・ツールを使用して一部のリクエストを手動で行います。

Sites Management用のREST APIでは、OAuthを使用した認証が必要なため、最初にOAuthトークンを取得する必要があります。 curlを使用してREST APIにアクセスでき、認証にOAuthを使用する必要があります。 詳細は、「OAuthを使用したOracle Content Managementとの統合」を参照してください。

curlのインストール

curlコマンドライン・ツールを使用して、Sites Management用のREST APIにアクセスできます。 Oracle Content Managementサーバーに安全に接続するには、SSLをサポートするcurlのバージョンをインストールし、Verisign CA証明書に対して認証するためのSSL認証局(CA)証明書ファイルまたはバンドルを提供する必要があります。

次の手順では、Windows 64ビット・システムにcurlをインストールする方法について説明します:

  1. ブラウザで、https://curl.haxx.seのcurlホーム・ページに移動し、「ダウンロード」をクリックして、curlのダウンロードの手順に従います。

  2. curlリリースおよびダウンロード・ページで、オペレーティング・システムに対応するSSL対応バージョンのcurlソフトウェアを探し、リンクをクリックしてzipファイルをダウンロードし、ソフトウェアをインストールします。

  3. https://curl.haxx.se/docs/caextract.htmlのcurl「CA証明書」ページに移動し、curlがインストールされているディレクトリにSSL CA証明書バンドルをダウンロードします。

  4. コマンド・ウィンドウを開き、curlをインストールしたディレクトリに移動し、curl環境変数CURL_CA_BUNDLEをSSL認証局(CA)証明書バンドルのロケーションに設定します:

    C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

これで、curl を使用してOracle Content Managementにリクエストを送信する準備ができました。

OAuthの使用

2段階のプロセスで、OAuthを使用するようにリクエストを設定します。 まず、OAuthトークンを取得し、次にこのトークンを使用してREST APIにアクセスします。

  1. コマンドラインから次のURLを入力します:

    curl -X POST \
https://<IDCS BaseURL>/oauth2/v1/token \
-H 'Authorization: Basic <Base64 encoded clientID:clientSecret>' \
-H 'Host: <idcs hostname>' \
-d 'grant_type=client_credentials&scope=https%3A%2F%<ServiceInstanceBaseURL>%3A443%2Furn%3Aopc%3Acec%3Aall'

    documents/webコンテキストは、Oracle Identity Cloud Services (IDCS)によって保護されています。 ブラウザに有効なIDCSセッションがすでに存在する場合を除き、ユーザーはIDCSにサインインするように求められます。

    OAuthトークンは、JSONレスポンスのtokenValueフィールドに返されます。 トークンの有効期限は秒で指定され、通常は7日間です。

  2. トークンおよびアクセス・サイト管理のREST APIエンドポイントを使用するには、Bearer Authorizationヘッダーを使用します。たとえば:

    curl -i -H 'Authorization: Bearer token' --request GET

https://Oracle-Content-Management-URL/sites/management/api/v1/sites