エネがえるAPIサービスを実装される方へ
作成者：桑田 正英と他2名3 人の著者20件の記事
- 電気料金計算で指定する契約容量について (V4)
- 電気料金プランの基本料金計算方法について (V4)電気料金プラン取得API (epplans) のレスポンスに含まれる 基本料金計算方法 (base_type) について
- APIの呼び出しにトークンが必要ですが、有効期限はありますか？有効期限自体は設定していません。二重ログインが行われた場合には古いトークンが無効となります。
- 電気料金（円）から電気使用量（kWh）を逆算するAPIはありますか？はい。useepchargecalc API をご利用ください。詳細は以下ご参照ください。
- 2026年11月の電気料金単価反映について電気料金データベースは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の結果一覧レスポンスの並び順を替えていただくことは可能でしょうか。はい可能です。個別にご相談ください。
- 電力広域的運営推進機関が発行している電力事業者コードを追加していただくことは可能でしょうか。電気事業者のマスタから広域機関登録電力事業者コード、METI登録電気事業者コードが取得できます。
- 電力事業者名の表記はどのように決定していますか？電力事業者の呼び方と各電力事業者のサイトにある約款上の名称を元に記載しています。
- 電力事業者名にアルファベットが含まれている場合、多くが半角になっていますが、全角のものもあります。こちらも電力事業者自身の表記に倣っているということでしょうか？エネがえるAPI仕様では、原則、半角で統一しています。例外的に小売電気事業所登録名が全角となっている場合もあるため、その場合は全角に合わせています。
- 送配電エリアを選択してもらいシミュレーションすることは可能か？（郵便番号や都道府県ではなく、送配電エリアをユーザーに選択させたい）はい、可能です。
- 郵便番号と旧電力事業者の紐づけ、電力事業者の紐づけを教えてもらえますか？API契約企業様にはExcel等でリストを送付させていただきます。
- 電気契約プラン取得APIの結果レスポンスの中で容量契約となる電気料金プラン(base_typeが2,3,5,6))の場合に、プランが複数に別れていたり(ある容量を超えると1kW刻みでプランが別れている)、2つのみのプランだったり(ある容量を超えても1kW刻みでプランが別れていない)しますがなぜでしょうか？一定容量を超えると、契約容量ごとに1kW刻みに料金計算が異なる場合、別プランとして登録しています。
- 共通公開APIのユーザー管理（uidの扱い）とエラー・再試行の確認方法共通公開APIの認証ヘッダー、強制ログイン、401/403の区別、再試行時の確認事項を説明します。旧V4・契約別APIは対象仕様を確認してください。
- エネがえるAPI - 電力会社の検索は何をキーにするのか？電力会社の検索は「都道府県」または「郵便番号」を使って検索ができます。郵便番号は定期的にメンテナンスしています。市区町村単位は変更の頻度が多すぎるため対応していません。