電気料金比較シミュレーションAPI

基本情報

API名: 電気料金比較シミュレーションAPI

説明: 地域コード、アンペア数（AまたはkVA）、検針月、月間電気使用量（kWh）、およびカスタムURLを基に、電気料金の計算および各種の情報提供を行うAPIです。

認証

タイプ: Bearer Token (APIキー)

使用方法: APIリクエストのヘッダーにAuthorization: Bearer <あなたのAPIキー>を追加して認証情報を提供します。

エンドポイント情報

エンドポイントURL: https://npc-share.com/api/ec-estimator/calculate

メソッド: POST

コンテントタイプ: application/json

リクエストパラメータ

area (必須): 地域コード

• 1 = "北海道"
• 2 = "東北"
• 3 = "北陸"
• 4 = "中部"
• 5 = "東京"
• 6 = "関西"
• 7 = "中国"
• 8 = "四国"
• 9 = "九州"
• 10 = "沖縄"

amp (必須): アンペア数

• amp0 = "関西・中国・四国の6kVA未満のプランと沖縄が対象"
• amp10 = "10A"
• amp15 = "15A"
• amp20 = "20A"
• amp30 = "30A"
• amp40 = "40A"
• amp50 = "50A"
• amp60 = "60A"
• kva6 = "6kVA"
• kva7 = "7kVA"
• kva8 = "8kVA"
• kva9 = "9kVA"
• kva10 = "10kVA"
• kva11 = "11kVA"
• kva12 = "12kVA"
• kva13 = "13kVA"
• kva14 = "14kVA"
• kva15 = "15kVA"
• kva16 = "16kVA"
• kva17 = "17kVA"
• kva18 = "18kVA"
• kva19 = "19kVA"
• kva20 = "20kVA"
• kva21 = "21kVA"
• kva22 = "22kVA"
• kva23 = "23kVA"
• kva24 = "24kVA"
• kva25 = "25kVA"
• kva26 = "26kVA"
• kva27 = "27kVA"
• kva28 = "28kVA"
• kva29 = "29kVA"
• kva30 = "30kVA"
• kva31 = "31kVA"
• kva32 = "32kVA"
• kva33 = "33kVA"
• kva34 = "34kVA"
• kva35 = "35kVA"
• kva36 = "36kVA"
• kva37 = "37kVA"
• kva38 = "38kVA"
• kva39 = "39kVA"
• kva40 = "40kVA"
• kva41 = "41kVA"
• kva42 = "42kVA"
• kva43 = "43kVA"
• kva44 = "44kVA"
• kva45 = "45kVA"
• kva46 = "46kVA"
• kva47 = "47kVA"
• kva48 = "48kVA"
• kva49 = "49kVA"

selectedMonth (必須): 検針月

• month1 = "2024年1月"
• month2 = "2024年2月"
• month3 = "2024年3月"
• month4 = "2024年4月"
• month5 = "2023年5月"
• month6 = "2023年6月"
• month7 = "2023年7月"
• month8 = "2023年8月"
• month9 = "2023年9月"
• month10 = "2023年10月"
• month11 = "2023年11月"
• month12 = "2023年12月"

※毎月15日に次月分の更新が反映されます。

kWh (必須): 電気使用量

0以上の任意の整数

customUrl (必須): 専用URLの末尾

（例: 55555）

レスポンス構造

success: 処理の成功または失敗（true/false）

data: 計算結果および各プランの詳細情報を含むオブジェクト。planDataとcommonDataが含まれます。

planData：

• プランID（例：101）
  ダッシュボード上で各プランのIDを確認できます）
• 月額料金（ans）① 参照
• 基本料金（amp）
• 各社調整額（nencho）②,③ 参照
• プラン名称（custom_plan_name）
• プラン説明（custom_plan_description）

commonData：

• 再生可能エネルギー発電促進賦課金の月額料金（monthsaienefukakin）
• 実際の年月（realyear）
  （例：2024年3月）
• 選択月（realmonth）

① 月額料金（ans）からampとnenchoとmonthsaienefukakinの合計を引いた金額が’従量料金’部分になります。

② 調整額と再エネ賦課金はリクエストパラメータのkWhで割ると1kWhあたりの単価になります。

③一部の新電力会社の’容量拠出金’は調整額に含めています。

使用例 (JavaScript fetch API):

            fetch('https://npc-share.com/api/ec-estimator/calculate', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                    'Authorization': 'Bearer ここにあなたのAPIキー'
                },
                body: JSON.stringify({
                    area: "〇〇（1～10のいずれか）",
                    amp: "〇〇〇（amp0～kva49のいずれか）",
                    selectedMonth: "〇〇〇〇（month1～month12のいずれか）",
                    kWh: "〇〇〇（0以上の任意の整数）",
                    customUrl: "〇〇〇〇（あなたのカスタムURL末尾）"
                }),
                credentials: 'include'
            })
            .then(response => response.json())
            .then(data => console.log(data))
            .catch(error => console.error('Error:', error));