メインコンテンツにスキップ

エネがえるAPIサービス

エネがえるAPIについて

エネがえるAPIではどんなことができますか？仕様書は？エネがえるAPIではオンライン仕様書を公開しております。以下ご参照ください。
新規太陽光と既設太陽光のシミュレーションAPIの違い (V4API)一言でいうと、使用量ベースの計算か買電量ベースの計算かの違いになります。
そもそもAPIってなに？JSON形式って？参考になるわかりやすい参考記事やYoutube動画をご参照ください
エネがえるAPIを使用した独自アプリケーションの開発・実装についてエネがえるAPIサービスを初めて利用される事業開発・サービス開発、エンジニアの方向け
エネがえるAPIで計算された結果を検証する際に、数値が異なる気がするがどうしたらいいか？エネがえるAPIのリクエスト・レスポンスデータと診断の前提条件をメールで送付してください。詳細お調べし、要因と対策をご報告いたします。
自治体スマエネ補助金データAPIサービスとは？国・都道府県別・市区町村別の約2,000件の再エネ・脱炭素関連の補助金が月1回自動更新されるAPIです。貴社Webサイトやシステムに組み込めます。自治体の創蓄省エネ（脱炭素・再生可能エネルギー）関連の補助金のデータベースをAPI経由で使えます。Excelデータ提供も可です。
エネがえるAPIサービスを実装される方へ

電気料金計算で指定する契約容量について (V4)
電気料金プランの基本料金計算方法について (V4)電気料金プラン取得API (epplans) のレスポンスに含まれる 基本料金計算方法 (base_type) について
epcorp_cdおよびplan_cdは不変でしょうか？不変となります。運用上、epcorp_cdおよびplan_cdが変更になることはございません。
APIの呼び出しにトークンが必要ですが、有効期限はありますか？有効期限自体は設定していません。二重ログインが行われた場合には古いトークンが無効となります。
APIを実装する際に、比較対象の電力事業者、料金プランは表示・非表示の取捨選択（フィルタリング）が自動でできますか？電力事業者単位はエネがえるASP管理画面でONOFF設定ができます。プラン単位はAPI実装側で対応が必要です。
電気料金（円）から電気使用量（kWh）を逆算するAPIはありますか？はい。useepchargecalc API をご利用ください。詳細は以下ご参照ください。
電力事業者と電気料金プランの更新タイミングは決まっていますか？毎月2回更新タイミングがあります。以下ご参照ください。
電力事業者情報取得APIでは、 都道府県(V4)または郵便番号(V3)でしか絞り込みができませんが、旧電力管内での絞り込みは可能でしょうか。はい、旧電力事業者コード(oldepcorp_cd)を使い絞り込むことが可能です。
電力事業者情報取得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の認証とユーザー管理を適切に行うため、以下のポイントを押さえましょう。
エネがえるAPI - 電力会社の検索は何をキーにするのか？電力会社の検索は「都道府県」または「郵便番号」を使って検索ができます。郵便番号は定期的にメンテナンスしています。市区町村単位は変更の頻度が多すぎるため対応していません。