API トークン | Procurize.AI#

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

対象: Procurize.AI ダッシュボード → 設定 → トークン
利用可能プラン: Business および Enterprise プラン
必要なロール: Security Manager、Editor、Admin、または Maintainer

概要#

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

主な特徴:

🔒 セキュリティ注意: Procurize.AI はトークンの値を 保存しません – ハッシュのみ保存します。生成直後にトークンをコピーして安全に保存する必要があります。再表示はされません。

API トークンページ

必要な権限: Security Manager、Editor、Admin、または Maintainer ロールを持つユーザーのみがこのパネルにアクセスできます。ロールの詳細は Permissions Overview を参照してください。

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

新しい 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-*` ヘッダーを確認してください。