メインコンテンツにスキップ
すべてのコレクションエネがえるAPIサービス
エネがえるAPIサービスを実装される方へ
エネがえるAPIサービスを実装される方へ
電気料金計算で指定する契約容量について (V4)
電気料金プランの基本料金計算方法について (V4)電気料金プラン取得API (epplans) のレスポンスに含まれる 基本料金計算方法 (base_type) について
epcorp_cdおよびplan_cdは不変でしょうか?不変となります。運用上、epcorp_cdおよびplan_cdが変更になることはございません。
APIの呼び出しにトークンが必要ですが、有効期限はありますか?有効期限自体は設定していません。二重ログインが行われた場合には古いトークンが無効となります。
エネがえるの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の結果レスポンスの中で動力プラン(力率プラン)の場合に、プランが3つに別れていたり、契約種別が、電力契約(力率:90%)、電力契約(力率:85%)、電力契約(力率:80%)で別れている1つのプランだったり(電力契約で別れていない)しますがなぜでしょうか?エネがえるAPIの仕様では、力率の大きさによって、割引がそれぞれ異なる場合に複数レコード分けています。
API実行時のユーザーについて
エネがえるAPI - 電力会社の検索は何をキーにするのか?電力会社の検索は「都道府県」または「郵便番号」を使って検索ができます。郵便番号は定期的にメンテナンスしています。市区町村単位は変更の頻度が多すぎるため対応していません。