Postman コレクション

各コントラクトには、サンドボックス URL とリクエストボディのサンプルが事前設定された Postman コレクションが付属しています。コレクションをインポートし、認証情報を入力すれば、コードを書かずにすべてのエンドポイントを呼び出すことができます。

コントラクト別コレクション

コントラクト	コレクション	備考
認証	ダウンロード	以下のファイルをダウンロードし、Postman にインポートして、"service_account"、"tenant_id"、"secret_key" パラメーターの値を置き換えてリクエストをテストしてください。
Web & SDK	ダウンロード	プロセス作成、GET プロセス、GET エビデンス、GET PDF を含みます。
API	ダウンロード	プロセス作成（POST）と GET プロセスを含みます。

セットアップ

1. 統合しているコントラクトのコレクションをダウンロードします。
2. Postman でインポートします：File > Import > Upload Files。
3. コレクションに応じて認証情報を設定します：

認証 — コレクションを開き、Variables タブに移動して、以下を入力します：

変数	値
service_account	サービスアカウント名。
tenant_id	テナント ID。
secret_key	秘密鍵（PEM 形式）。
base_path	トークンエンドポイントのホスト。デフォルトは UAT（https://identityhomolog.acesso.io）。本番の場合は https://identity.acesso.io に変更してください。

Web & SDK — 各リクエストを開き、Authorization: Bearer の値を自分のアクセストークンに置き換えます。

API — 各リクエストを開き、Authorization: Bearer と APIKEY ヘッダーの値を自分の認証情報に置き換えます。

4. 認証リクエストを実行 — 事前リクエストスクリプトが自動的に JWT アサーションを構築して {{jwt_token}} に保存します。

事前リクエストスクリプト

認証コレクションのみ事前リクエストスクリプトが含まれています。スクリプトの内容：

• コレクション変数から service_account、tenant_id、secret_key、base_path を読み取ります。
• 組み込みの KJUR ライブラリを使用して JWT アサーション（RS256）を構築および署名します。
• 署名済みトークンを {{jwt_token}} に保存し、リクエストボディに自動的に挿入されます。

Web & SDK および API コレクションには事前リクエストスクリプトはありません — 認証情報はリクエストヘッダーに直接設定します。

次のステップ

• 認証 — コレクションが必要とする認証情報を生成します。
• Web & SDK の概要 — Web & SDK コレクションのコンテキスト。
• API の概要 — API コレクションのコンテキスト。