---
title: "查询电费数据"
method: POST
path: "/api/data/electricfees"
tags: ["Data"]
---

# 查询电费数据

`POST /api/data/electricfees`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/data/electricfees`
- Auth: HTTP bearer

## Request body `application/x-www-form-urlencoded`

- object
  - `name` string
  - `number` integer
  - `year` integer

## Response `200`

Successful HTTP response; legacy business endpoints may return success=false in this envelope, while social endpoints use matching 4xx/5xx statuses

- CommonPojoResultDataJsonResultCommonPojoEntityElectricFees
  - `code` integer
  - `data` CommonPojoEntityElectricFees
    - `averageElectricBill` number
    - `buildingNumber` string
    - `department` string
    - `electricPrice` number
    - `feeBasedElectricAmount` number
    - `freeElectricAmount` number
    - `name` string
    - `number` integer
    - `peopleNumber` integer
    - `roomNumber` integer
    - `totalElectricBill` number
    - `usedElectricAmount` number
    - `year` integer
  - `errorCode` string
  - `message` string
  - `success` boolean

## Other responses

- `400`: Request validation failure; legacy endpoints may still return HTTP 200 with success=false
- `401`: Missing, expired or invalid bearer token
- `403`: Forbidden or privacy restriction
- `429`: Rate limited
- `500`: Server failure; legacy endpoints may still return HTTP 200 with success=false

## Changes

- **2026-11-04** `bbd151b5879f`: 2 info
  - api tag `Data` added
  - api tag `DataQuery` removed
- **2026-10-06** `880521a9d345`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gdeiassistant/apis/gdeiassistant-api/changes/api/data/electricfees/post.md)

---

[API](https://skmtc.dev/gdeiassistant/apis/gdeiassistant-api.md) - [All operations](https://skmtc.dev/gdeiassistant/apis/gdeiassistant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gdeiassistant/apis/gdeiassistant-api/revisions/b3983583c335?raw)