エネがえるAPIサービス
API連携・開発者向けの仕様と利用方法。ASP／Biz／EV・V2Hの画面に出る「API内部エラー」は「不具合やバグ」をご覧ください。
作成者：樋口と他2名3 人の著者40件の記事
- エネがえるAPIではどんなことができますか？仕様書は？結論：エネがえるAPIは再エネ設備の経済効果試算、料金単価・補助金データ参照などをシステムへ組み込む有償APIです。用途別の最新仕様書を確認してください。
- 新規太陽光と既設太陽光のシミュレーションAPIの違い (V4API)一言でいうと、使用量ベースの計算か買電量ベースの計算かの違いになります。
- そもそもAPIってなに？JSON形式って？参考になるわかりやすい参考記事やYoutube動画をご参照ください
- エネがえるAPIを使用した独自アプリケーションの開発・実装について結論：エネがえるAPIを使った独自Web・業務アプリを開発できます。認証情報はブラウザへ埋め込まず、原則として自社サーバーからAPIを呼び出してください。実装時は最新の公式API仕様を正本とします。
- エネがえるAPIで計算された結果を検証する際に、数値が異なる気がするがどうしたらいいか？エネがえるAPIのリクエスト・レスポンスデータと診断の前提条件をメールで送付してください。詳細お調べし、要因と対策をご報告いたします。
- 【API】自治体スマエネ補助金データAPIサービスとは？国・都道府県別・市区町村別の約5,000件の再エネ・脱炭素関連の補助金が月1回自動更新されるAPIです。貴社Webサイトやシステムに組み込めます。自治体の創蓄省エネ（脱炭素・再生可能エネルギー）関連の補助金のデータベースをAPI経由で使えます。Excelデータ提供も可です。
- エネがえるAPI よくある質問（目的・ユースケース別）エネがえるAPIの仕様書およびこれまでの会話履歴に基づき、開発者や導入検討者が目的別・ユースケース別に機能を探せる「Intercom形式のFAQ（よくある質問）」を作成しました。
- 市場連動型料金プラン対応APIに関するFAQエネがえるAPI（新仕様）における「市場連動型料金プラン」への対応について、仕様書に基づき開発者向けの詳細なFAQを作成しました。
- エネがえる市場連動型料金プラン対応APIの計算ロジックは？エネがえるAPI（新仕様 /sys/epchargecalc）における、市場連動型プラン（epplanType=2）のシミュレーション計算ロジックは以下の通りです。APIは「過去12ヶ月の市場価格実績」と「30分ごとの使用量」を突き合わせて計算を行います。
- 電気料金計算で指定する契約容量について（API）結論：契約容量は実契約値を優先し、default_volは欠損時の概算に限定します。単位・プラン条件・現行API仕様を確認してください。
- 電気料金プランの基本料金計算方式について（API）結論：基本料金方式は現行API仕様と料金プランマスターで判定します。旧base_type番号をハードコードせず、契約仕様とテストを正本にしてください。
- APIの呼び出しにトークンが必要ですが、有効期限はありますか？有効期限自体は設定していません。二重ログインが行われた場合には古いトークンが無効となります。
- 電気料金（円）から電気使用量（kWh）を逆算するAPIはありますか？結論：契約中の仕様でuseepchargecalcが提供されている場合、電気料金から電気使用量を近似逆算できます。API世代・入力制約を最新仕様書で確認してください。
- 電力事業者と電気料金プランの更新タイミングは決まっていますか？結論：料金単価は原則として毎月月末に更新し、翌月1日に本番反映します。随時依頼や緊急対応は個別確認で、反映日を保証するものではありません。
- 電力事業者情報取得APIで取得した結果に自分が比較したい電力事業者がないのですが追加できるでしょうか。はい。API契約企業であれば新規登録依頼に対応します。約1ヶ月のリードタイムがかかります。
- APIのリソース名はどのようなルールでリソース命名されているでしょうか。以下ご参照ください。
- APIのレスポンスのHTTPステータスコードの返却ルールはあるでしょうか。RESTのコード返却に準拠しております。
- Content-Type以外のHTTPヘッダーは、何を設定したら良いか？Content-Type: application/json、x-api-key: APIキー、Authorization: uid を設定してください。
- 電力事業者コード(corp_cd)を指定して、事業者情報を1件取得できるAPIがあるとうれしいです。例) /v4/epcorps/4
- 電力事業者コード(METIコード)には対応していますか？結論：電気事業者マスターから広域機関登録コードとMETI登録電気事業者コードを取得できます。項目名・欠損可否は契約中のAPI仕様を確認してください。
- 電力事業者情報取得API、契約電気プラン取得API、蓄電池情報取得APIの結果一覧レスポンスの並び順を替えていただくことは可能でしょうか。結論：APIレスポンスの順序は業務ロジックとして依存せず、利用側で明示的に並べ替えてください。マスター順変更や個別仕様は要件確認後の回答です。
- 電力広域的運営推進機関が発行している電力事業者コードを追加していただくことは可能でしょうか。電気事業者のマスタから広域機関登録電力事業者コード、METI登録電気事業者コードが取得できます。
- 電力事業者名の表記はどのように決定していますか？電力事業者の呼び方と各電力事業者のサイトにある約款上の名称を元に記載しています。
- 電力事業者名にアルファベットが含まれている場合、多くが半角になっていますが、全角のものもあります。こちらも電力事業者自身の表記に倣っているということでしょうか？エネがえるAPI仕様では、原則、半角で統一しています。例外的に小売電気事業所登録名が全角となっている場合もあるため、その場合は全角に合わせています。
- 送配電エリアを選択してもらいシミュレーションすることは可能か？（郵便番号や都道府県ではなく、送配電エリアをユーザーに選択させたい）はい、可能です。
- 郵便番号と旧電力事業者の紐づけ、電力事業者の紐づけを教えてもらえますか？API契約企業様にはExcel等でリストを送付させていただきます。
- 電気契約プラン取得APIの結果レスポンスの中で容量契約となる電気料金プラン(base_typeが2,3,5,6))の場合に、プランが複数に別れていたり(ある容量を超えると1kW刻みでプランが別れている)、2つのみのプランだったり(ある容量を超えても1kW刻みでプランが別れていない)しますがなぜでしょうか？結論：容量契約プランが複数レコードに分かれるのは、契約容量帯・計算条件を区別するためです。表示名だけで集約せず、IDと適用容量条件で扱ってください。
- API実行時のユーザー管理（UIDの扱い）およびリトライ処理についてAPIの認証とユーザー管理を適切に行うため、以下のポイントを押さえましょう。
- エネがえるAPI - 電力会社の検索は何をキーにするのか？電力会社の検索は「都道府県」または「郵便番号」を使って検索ができます。郵便番号は定期的にメンテナンスしています。市区町村単位は変更の頻度が多すぎるため対応していません。
- 自社のWebにエネがえるのようなシミュレーターをカンタンに組み込めないか？はい、可能です。デザイン・エネがえるAPI実装・サーバ運用など丸投げ可能なパッケージを作りました。ご相談ください。
- APIのテスト環境や無料トライアルはありますか？はい。共通アカウントでのテスト環境提供、無料トライアル用APIアカウントを発行可能です。
- 【API】エネがえるのカスタマイズは可能か？（電気料金参照API、電気料金比較API、太陽光・蓄電池経済効果試算API、EV・V2H関連API、産業用APIなど）はい、可能です。ただし、別途有償提供しているエネがえるAPIサービスを活用いただく必要がございます。APIを活用すれば、貴社独自のシミュレーターやWebシミュレーターを実装いただけます。詳細は以下をご参照ください。
- エネがえるAPIの相談、見積もり依頼をするには？以下の要件ヒアリングチェックリストを参考に、ご相談ください。見積もりが素早くご提示できます。需要家向けWEBシミュレーターの型と、営業担当・店舗担当向けの経済効果試算・提案書自動作成ツールの型の2種類のヒアリングシートをご用意しています。
- エネがえるAPIが自社要件にマッチするかどうか？Yes/Noで確定｜要件→最適API構成 自動判定テンプレ最新版の共通公開API仕様書を起点に、目的・入力データ・契約別要件から必要なエンドポイントを判定するテンプレです。