📚 エネがえるAPI よくある質問（目的・ユースケース別）
🔐 認証・基本設定
Q. APIを利用し始めるための認証手順は？
A. 基本的に以下のステップで認証を行います。
ログインAPIを実行: 事前に発行された「ユーザーID」「パスワード」「APIキー」を使用し、ログインAPI（例：
/sys/login、/v4/loginなど）をPOSTします。アクセストークンの取得: レスポンスに含まれる
uid（アクセストークン）を取得します。APIリクエスト: 以降のAPI呼び出しでは、リクエストヘッダーに
x-api-keyとAuthorization（取得したuid）をセットして実行します。 ※ AIsense APIの場合はトークンの有効期限は24時間です。
Q. よくあるエラーコードと対処法は？
A. 主なエラーコードは以下の通りです。
400 (Bad Request): パラメータ指定の誤りなど。エラーメッセージを確認してください。
403 (Forbidden): 認証エラー。トークンの有効期限切れや、APIキーのセット忘れを確認してください。
500 (Internal Server Error): システム内部エラー。エネがえる担当者へお問い合わせください。
504 (Gateway Timeout): 処理のタイムアウト。再実行しても解消しない場合はお問い合わせください。
🏠 住宅用シミュレーション（太陽光・蓄電池・EV）
Q. 太陽光・蓄電池の導入効果（自家消費シミュレーション）を行いたい
A. /v4/pvcellsimulation APIを使用します。 電気使用量、太陽光発電量、蓄電池スペック（容量、充放電時間帯など）を入力することで、時間ごとの「自家消費量」「売電量」「蓄電池充放電量」などを計算できます。
Q. EV（電気自動車）やV2Hの導入効果を試算したい
A. /ev/v2hsimulations APIを使用します。 EVの電池容量、V2H機器のスペック、EVの走行パターン（平日・休日の外出時間や走行距離）を考慮したシミュレーションが可能です。
Q. 過去の電気料金プランと新しいプランの料金比較をしたい
A. /v4/epdiagnosis（電気料金診断）APIを使用します。 現在の契約アンペアや使用量データに対し、複数の比較対象プランを指定することで、それぞれの年間・月間電気料金を計算し、ランキング形式で取得できます。
🏭 産業用シミュレーション（自家消費・ピークカット）
Q. 工場やビルの高圧電力契約でのシミュレーションは可能ですか？
A. はい、Biz（産業用）APIの /biz/equipsimulation で可能です。 30分値（または1時間値）のデマンドデータに基づき、産業用蓄電池を使ったピークカット（基本料金削減）や、自家消費による従量料金削減効果をシミュレーションできます。
Q. 独自の電気料金プラン（高圧など）を作成して試算に使いたい
A. /biz/customepplans APIを使用します。 基本料金の計算方式（契約電力方式、実量制など）や、季節・時間帯別の従量単価を詳細に設定した「カスタムプラン」を登録し、シミュレーションに利用できます。
📊 データ取得・検索（補助金・料金プラン）
Q. 補助金情報を検索したい
A. /sys/subsidy APIを使用します。 「都道府県」「市区町村」「対象設備（太陽光、蓄電池、EVなど）」「対象者（個人・法人）」などの条件を組み合わせて、該当する補助金制度を検索できます。
Q. 市場連動型の電気料金プランに対応していますか？
A. はい、新仕様のAPIで対応しています。 料金プラン情報（epplans）の epplanType が 2 のものが市場連動型プランです。計算時には、API実行時の前月までの最新12ヶ月分のエリアプライス（市場価格）を参照して料金計算を行います。
Q. 住所から電力会社や日射量エリアを特定したい
A. 以下のAPIが利用できます。
/sys/epcorps: 都道府県や郵便番号から、その地域で契約可能な電力会社一覧を取得します。/v4/zipcds/{zip_cd}: 郵便番号から都道府県コードを取得します。/v4/sunpoints: 都道府県コードから、JISに基づく日射量観測地点を取得します。
🤖 最適制御・予測（AIsense API）
Q. 翌日の太陽光発電量や気象データを取得したい
A. AIsense APIを使用します。
/aisense/forecasts/pv/: 指定した設備（パネル容量・方位など）に基づく発電量予測を取得します。/aisense/weather/forecast/: 気温、湿度、日射量などの気象予測データを取得します。
Q. AIによる蓄電池の最適制御スケジュールを取得したい
A. /aisense/controls_cell/ APIを使用します。 気象予報や需要予測に基づき、経済性を最大化（または余剰活用など）するための、30分ごとの最適な充放電スケジュール（AI制御情報）を取得できます。