アクセストークン取得API

1. API 概要

API名: アクセストークン取得API

目的: intra-mart Procurement Cloudの外部用APIを実行するためのアクセストークンを取得する。

概要: このAPIは、intra-mart Procurement CloudのAPIを実行するためのアクセストークンを取得します。 リクエストには必要なフィールドが含まれ、レスポンスは登録の成功/失敗を示します。

2. リクエスト

2.1 リクエストURL

メソッド：POST
ドメイン：お問い合わせください。
エンドポイント：お問い合わせください。

2.2 リクエストヘッダー

2.3 リクエストボディ

リクエストボディにはx-www-form-urlencoded形式でデータを含めます。以下はその例です。

例

client_id=CLIENT_ID&username=USERNAME&password=PASSWORD&grant_type=password&client_secret=CLIENT_SECRET

2.4 パラメータ説明

3. レスポンス

3.1 レスポンス成功時

ステータスコード: 200 OK

パラメータ説明

レスポンス例

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "expires_in": 7200,
  "refresh_expires_in": 2592000,
  "refresh_token": "dGVzdC1yZWZyZXNoLXRva2VuLTYyY2FhYzQ2YTM5ODMyNmRhYmViN2JlNTMx",
  "token_type": "Bearer",
  "not-before-policy": 0,
  "session_state": "4bbf1234-0000-5555-2222-537123447c7d",
  "scope": "profile email"
}

3.2 レスポンス失敗時

ステータスコード: 400 Bad Request (リクエストが不正)

レスポンス例(バリデーションエラー)

{
    "error": "invalid_request",
    "error_description": "Missing form parameter: grant_type"
}

ステータスコード: 401 Unauthorized (認証に失敗)

レスポンス例(認証エラー)

{
    "error": "invalid_client",
    "error_description": "Invalid client or Invalid client credentials"
}

4. エラーハンドリング

5. その他の注意点

• なし