機械翻訳について
  1. Oracle Fusion Cloud ProcurementのOracle Fusion Cloud ProcurementREST APIのREST API
  2. さらに学ぶ
  3. RESTクライアントの操作

RESTクライアントの操作

REST APIはHTTPメソッドを使用してコンテンツを送受信するため、HTTPメッセージの送受信をサポートする任意のプログラミング言語またはツールを使用して、REST APIをテストできます。 まず、HTTPリクエストを作成するためのツールを選択します。

ノート:

Oracle REST APIはOData (Open Data Protocol)に準拠していません。

RESTクライアントの選択に関する考慮事項

Fusion Procurementと対話するクライアントの中から、次のようなクライアントを選択できます:

クライアントを使用して、次のタスクを実行できます:

  • REST APIアカウントのユーザー名、パスワードおよびリクエストURLをテストします。

  • RESTリソース、属性およびパラメータについてさらに学習するには、viewおよびdescribeアクションを実行します。

  • 収集された情報を使用して、様々なタイプのHTTPリクエスト(レコードの作成、更新または削除など)を構成および送信します。

cURLを使用してHTTPリクエストを送信する方法

この例では、URL構文を使用してデータを転送する一般的なコマンドライン・ユーティリティであるcURLを使用して、RESTサービスにリクエストを送信します。ほとんどのUNIX、WindowsおよびMacintosh環境では、cURLを使用できます。 詳細は、「WindowsへのcURLコマンドライン・ツールのインストール」を参照してください。

次の表に、RESTサービスに使用できる、一般的に使用されるcURLオプションを示します。

オプション 説明

-user

username:password

サーバー認証のユーザー名とパスワードを指定します。

-d

指定したデータ(JSONリクエスト本文)をサーバーに送信します。 データを@記号で開始する場合、データの読取り元のファイル名を@の後に付ける必要があります。

-H

リクエストに追加のHTTPヘッダーを指定します。 複数のヘッダーを指定するには、各ヘッダーの前に-Hオプションを付けます。

次に例を示します。
  • Content-Type: リクエスト本文の形式(POSTなど)
  • 同意: レスポンス本文の形式
  • X-Auth-Token: 認証トークン

-output

<file>

stdoutではなくファイルに出力を書き込みます。

-X

HTTPサーバーとの通信時に使用するリクエスト・メソッドを指定します。 デフォルトのメソッドはGETです。

次の表に、cURLを使用したGET、PATCHおよびPOST操作の例を示します。

操作 cURLコマンドの例

GETを使用して、すべての調達エージェントを取得します。 

curl  -u username:password \
-X GET https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/<version>/procurementAgents \
-H 'Content-Type: application/vnd.oracle.adf.resourceitem+json'

PATCHを使用して、調達エージェントを更新します。 

curl -u username:password \
-X PATCH -d @request_payload.json https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/<version>/procurementAgents/AssignmentId \
-H "Content-Type: application/vnd.oracle.adf.resourceitem+json"

POSTを使用して、調達エージェントを作成します。 

curl  -u username:password \
 -X POST -d @request_payload.json https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/<version>/procurementAgents \
 -H "Content-Type: application/vnd.oracle.adf.resourceitem+json"

クライアントを使用したHTTPリクエストの送信方法

スタンドアロン・クライアント、サードパーティのブラウザ拡張機能、または拡張RESTクライアントなどのアドオンを使用して、HTTPリクエストを送信できます。 次の表に、クライアントを使用したGET、POSTおよびPATCH操作の例を示します。

操作 レスポンス/ペイロードの例

GET: 1人の調達エージェントを取得します。

リクエストURL : https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/<version>/procurementAgents/AssignmentId

 
{
  "AssignmentId": 20000000000587,
  "Agent": "Brown, John",
  "AgentId": 8156,
  "AgentEmail": "john.brown@example.com",
  "ProcurementBU": "Vision Services",
  "ProcurementBUId": 458,
  "Status" : "Active",
  "StatusCode" : "Y",   
  ...  
}

POST: 1つの調達エージェントを作成します。

リクエストURL : https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/<version>/procurementAgents

 
{
     "AgentId": 300100008259523,
     "ProcurementBUId": 1003,
     "Status": "Active",
     "DefaultRequisitioningBU": null,
     "DefaultRequisitioningBUId": null,
     "DefaultPrinter": null,
     "ManageRequisitionsAllowedFlag": false,
     "AccessLevelToOtherAgentsRequisitions": "None",
     "ManageOrdersAllowedFlag": false,
     "AccessLevelToOtherAgentsOrders": "None",
     "ManageAgreementsAllowedFlag": false,
     "AccessLevelToOtherAgentsAgreements": "None",
     "ManageNegotiationsAllowedFlag": false,
     "AccessLevelToOtherAgentsNegotiations": "None",
     "ManageSourcingProgramsAllowedFlag": false,
     "AccessLevelToOtherAgentsSourcingPrograms": "None",
     "ManageCatalogContentAllowedFlag": false,
     "ManageSuppliersAllowedFlag": false,
     "ManageQualificationsAllowedFlag": false,
     "AccessLevelToOtherAgentsQualifications": "None",
     "ManageAslAllowedFlag": false,
     "AnalyzeSpendAllowedFlag": false
}

パッチ: 調達エージェントを更新します。

リクエストURL : https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/<version>/procurementAgents/AssignmentId

 
{
           "Agent" : "Johnson, John",
           "Status": "Inactive",
 }