認証

​

API キーの取得

1. Admina 管理画面にログインします
2. 右上のユーザー設定メニューから 設定 を選択します
3. 左側のナビゲーションメニューで API キー を選択します
4. 新しい API キーを作成 ボタンをクリックします
5. API キーの名前を入力し、有効期限を設定する場合は期限日を入力します
6. 作成 ボタンをクリックして API キーを生成します
7. 表示された API キーを安全な場所にコピーして保存します

​

リクエストへの認証情報の追加

​

ヘッダー形式

X-API-Key: YOUR_API_KEY

​

cURL での使用例

curl -H "X-API-Key: YOUR_API_KEY" \
  https://assist.i.moneyforward.com/api/v1/sessions

​

JavaScript での使用例

const response = await fetch('https://assist.i.moneyforward.com/api/v1/sessions', {
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

​

セキュリティベストプラクティス

• API キーをソースコードやクライアント側のコードに埋め込まないでください
• 環境変数やシークレット管理システムを使用して API キーを管理してください
• 不要になった API キーは削除してください
• 定期的に API キーをローテーションすることを検討してください
• 意外な場所からの API アクセスを監視してください

​

認証エラー

{
  "ok": false,
  "error": "Missing or invalid API key"
}