API トークン | Procurize.AI#

安全なプログラムアクセスのために、API トークンを生成、管理、使用します。

対象: Procurize.AI ダッシュボード → 設定 → トークン
利用可能プラン: Business & Enterprise プラン
必須ロール: 管理者またはメンテナー

概要#

API トークンは Procurize.AI プラットフォームへの安全なプログラムアクセスを可能にします。トークンを使用して、Procurize.AI を社内システムと統合したり、ワークフローを自動化したり、プラットフォーム上にカスタムアプリケーションを構築したりできます。

主な特徴:

🔒 セキュリティに関する注意: Procurize.AI はトークンの値を保存しません – ハッシュだけを保持します。生成直後にトークンをコピーして保存してください。再表示はされません。

API トークンパネル

必要な権限: 管理者またはメンテナーロールを持つユーザーのみがこのパネルにアクセスできます。ロールの詳細は権限概要をご覧ください。

生成後、トークンの値は一度だけ表示されます – すぐにコピーし、安全な場所（例: パスワードマネージャーや環境変数）に保管してください。

新しい API トークン

⚠️ このトークンの値は再表示できません。 Procurize.AI は検証用にハッシュのみを保存します。トークンを紛失した場合は直ちに無効化し、新しいトークンを生成してください。

トークンパネルには、生成されたすべてのトークンが以下の情報とともに一覧表示されます:

💡 無効化はトークンを削除せずに統合を一時停止したいときに便利です。

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 組織 ID は不要 – トークンは組織に紐付いているため、API が自動的にコンテキストを解決します。

ルール	説明
トークン権限	トークンは作成者のユーザー権限と完全に同じです。ユーザーのロールが変更されると、トークンの権限も自動的に更新されます。
組織バインディング	トークンは作成者の所属組織に結び付けられます。複数組織で同一トークンを使用することはできません。
トークンの可視性	トークンの値は一度だけ表示されます。すぐに保存してください。Procurize.AI はハッシュのみを保持します。
期限切れトークン	期限切れのトークンは自動的に無効化され、使用できません。必要に応じて新しいトークンを生成してください。

問題	解決策
「Invalid API key」エラー	トークンが正しくコピーされているか（余分なスペースがないか）確認してください。トークンが有効かつ期限切れでないかもチェックしてください。
ロール変更後にトークンが機能しない	トークンの権限はユーザーの現在のロールに合わせて更新されます。ユーザーが権限を失った場合、トークンも同様に失います。
トークン紛失	紛失したトークンを取り消し、新しいトークンを生成してください。
レートリミット	プランに応じた API レートリミットが適用されます。レスポンスヘッダーの `X-RateLimit-*` を確認してください。