認証

​

APIキーの取得

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

​

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

​

ヘッダー形式

Authorization: Bearer YOUR_API_KEY

​

cURL での使用例

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.itmc.i.moneyforward.com/api/v1/organizations

​

JavaScript での使用例

const response = await fetch('https://api.itmc.i.moneyforward.com/api/v1/organizations', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

​

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

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

​

認証エラー

{
  "statusCode": 401,
  "errorId": "unauthorized",
  "message": "Unauthorized"
}