エネがえるAPI仕様書パーフェクトガイド｜認証・API一覧・実装手順

01 / START HERE

最初に確認する、3つのこと

APIポータルで用途・商品・導入方法を確認する →

02 / API DIRECTORY

必要な処理から、APIを見つける

現行の公開定義に掲載された20のパスを整理しました。/xxxxは共通エラーの説明用パスのため、呼び出し先の一覧から除いています。

一致するAPIがありません。別の言葉か、パスの一部で検索してください。

名称が近いAPIでも入力・出力は異なります。詳細は仕様書の対象操作を開き、SchemaとExample Valueをあわせて確認してください。

03 / AUTHENTICATION

認証から、最初のリクエストまで

1. 接続先を確認する。公開仕様の本番ベースURLはhttps://api.enegaeru.comです。
2. ログインする。POST /sys/loginにx-api-keyを付け、JSON本文にusernameとpasswordを送ります。productの指定は利用するサービスに合わせて確認します。
3. uidを保持する。レスポンスのuidを、後続リクエストのAuthorizationヘッダーへ直接設定します。公開仕様はBearer方式として定義されていません。
4. 対象APIの認証要件を確認する。各操作のSecurityと必要な利用権限を照合し、入力・出力を小さなデータで確認します。

補助金APIを呼び出すcURL例

東京都の太陽光・蓄電池に関する個人向けデータを取得する例です。認証済みのuidとAPIキーを環境変数に設定して使います。ここではAPIを実行しません。

# 認証情報はサーバー側の環境変数で管理します。
# ENEGAERU_UID にはログインレスポンスの uid を設定します。
curl --fail-with-body --get \
  'https://api.enegaeru.com/sys/subsidy' \
  -H "x-api-key: ${ENEGAERU_API_KEY}" \
  -H "Authorization: ${ENEGAERU_UID}" \
  --data-urlencode 'prefecture_cd=13' \
  --data-urlencode 'facility_cd=01,02' \
  --data-urlencode 'target_class=個人' \
  --data-urlencode 'limit=20'

一覧レスポンスのnextTokenが返る場合は、次のリクエストへ渡します。制度の金額・期間などはGET /sys/subsidy/{id}の詳細も確認してください。認証情報をWebページのJavaScriptや公開リポジトリへ埋め込まないでください。

Swagger UIの読み方

1. 目次から分野を選び、対象メソッド・パスを開く。
2. Parameters／Request bodyで必須項目、型、単位、配列長を確認する。
3. Responsesで正常系とエラー系のSchema・サンプルを確認する。
4. 実行する場合は契約・権限・入力データを確認する。本番環境への実行であることに注意する。

04 / CALCULATION DESIGN

実装が動いた後に、結果の前提をそろえる

上記は処理構成の例です。出力をそのまま次の入力へ渡せるかは、各Schemaのフィールド名・単位・日付・粒度を照合して判断してください。

数値の解釈を変える重要条件

• 太陽光の出力はkW。pvpowercalcのpanels[].volは1方角あたりの出力です。2026年10月2日にkWhからkWへ表記が訂正されました。入力値・計算結果の変更はありません。
• 市場連動型は30分値。epchargecalcのday_purchaseは48要素が必要です。前月までの最新12か月のエリアプライスから同じ月を使うため、任意の過去年や将来の市場価格を再現する条件とは区別します。
• 料金単価の時点を記録する。燃料費調整・再エネ賦課金・容量拠出金は、原則として最新（前月）のデータを各月へ適用する仕様です。市場連動プラン、またはnoFuels=1では燃料費調整を適用しません。
• 年度をまたぐ賦課金は月別に確認。renewableUnitsを指定すると月別値を使います。1〜12月の12要素で、null・欠落は不可。renewableより優先されます。燃料費調整はfuelsによる月別指定が可能です。
• 日付と粒度をそろえる。設備導入シミュレーションでは、需要と太陽光発電量の日付対応を確認します。許容期間や配列長は対象APIの定義に従ってください。
• エネファームは料金計算を後続処理へ。enefarmsimulationの結果から、電気料金・ガス料金APIへ接続する構成です。料金まで一括で返るとは扱わないでください。

05 / TROUBLESHOOTING

エラーは、コードと本文をセットで確認

APIによってエラー本文がJSONではなくtext/plainで返る場合があります。すべての応答を無条件にJSONとして解析せず、HTTPステータスとContent-Typeを確認してください。

API利用上限・同時実行・タイムアウト・再試行・商用運用条件は、契約対象の仕様と照合してください。このガイドでは公開定義から確認できない数値を補っていません。

06 / WHAT CHANGED

実装に関係する主な更新

• 2026年10月2日：pvpowercalcのパネル出力単位をkWへ表記訂正。
• 2026年8月29日：設備設置済み住宅の消費量推定equipconsumptionestを追加。
• 2026年8月25日：applianceprofileの暖房パラメータを廃止。残ガスの返却形式をm³へ変更。エネファームAPIを仕様書に掲載。
• 2026年8月19日：ガス事業者・料金プラン取得APIを追加。電気料金関連に容量拠出金の項目を追加。

変更内容の全文と、その後の更新は仕様書冒頭の更新履歴で確認してください。バージョン表示だけで変更の有無を判断せず、利用する操作とSchemaも確認します。

07 / FAQ

API仕様書・連携開発のよくある質問

08 / NEXT STEP

作りたいサービスから、必要なAPIを整理する

用途、手元の入力データ、画面や帳票に出したい結果、想定利用件数をお知らせください。公開仕様の確認から、API導入・PoC・個別開発の進め方まで相談できます。

住宅用太陽光・蓄電池 ／ 産業用・自家消費 ／ EV・V2H ／ 電気料金・補助金 ／ 市場連動型料金