← กลับหน้าหลัก

📡 PEA API Docs v1

คู่มือการใช้งาน API ระบบข้อมูลสำนักงานการไฟฟ้าส่วนภูมิภาค เขต 1
ใช้ได้ฟรี ไม่ต้อง login — เหมาะสำหรับ Google Apps Script, n8n, Python, Excel

https://namepeaapi.pages.dev/api/v1

📑 Endpoints

1. ค้นหาสำนักงาน

GET /offices ค้นหาสำนักงานทั้งหมด พร้อม filter & pagination

ค้นหาสำนักงาน กรองตามขนาด กฟจ. หรือจุดรวมงาน รองรับ pagination และ sorting

Parameters

ชื่อค่าคำอธิบาย
q optionalstringคำค้น: รหัส, ชื่อย่อ, ชื่อเต็ม
sizeL, M, S, XSกรองตามขนาด
group8stringกรองตาม กฟจ. เช่น G8_01
groupCodestringกรองตามจุดรวมงาน เช่น D01
pagenumberหน้า (default: 1)
limitnumberจำนวนต่อหน้า (default: 50, max: 200)
sortcode, shortName, fullName, size, indexเรียงตาม
orderasc, descลำดับ (default: asc)

ตัวอย่าง

curl "https://namepeaapi.pages.dev/api/v1/offices?q=อุดร&size=L"

2. รายละเอียดสำนักงาน

GET /offices/{code} ดึงข้อมูลสำนักงาน 1 แห่งจากรหัส

ดึงข้อมูลสำนักงานจาก code เช่น D01101

curl "https://namepeaapi.pages.dev/api/v1/offices/D01101"

3. จัดกลุ่มสำนักงาน ⭐

GET /tools/group-offices จัดกลุ่มสำนักงานเป็น กฟจ.(...), กฟส.(...)

กรอกชื่อย่อ/ชื่อเต็ม/รหัส → จัดกลุ่มเป็นรูปแบบ กฟจ.(...), กฟส.(...) พร้อม copy ได้เลย

💡 รองรับหลาย format: กฟส.รณ., เรณูนคร, รณ., D06202

Parameters

ชื่อค่าคำอธิบาย
names requiredstringชื่อสำนักงาน คั่นด้วย , เช่น กฟส.รณ.,กฟส.ภผม.

ตัวอย่าง

# ชื่อย่อ
curl "https://namepeaapi.pages.dev/api/v1/tools/group-offices?names=กฟส.รณ.,กฟส.ภผม."

# ชื่อเต็ม
curl "https://namepeaapi.pages.dev/api/v1/tools/group-offices?names=เรณูนคร,ภูผาม่าน"

# Response:
# {
#   "data": {
#     "formatted": "กฟจ.(นพ.,ขก.),\nกฟส.(ธพ.,ชมพ.,รณ.,ภผม.)"
#   }
# }

4. สถิติ

GET /stats สถิติรวม จำนวนสำนักงานแยกขนาด/กลุ่ม
curl "https://namepeaapi.pages.dev/api/v1/stats"

# Response:
# {
#   "data": {
#     "totalOffices": 116,
#     "bySize": {"L": 8, "M": 17, "S": 47, "XS": 44},
#     ...
#   }
# }

5. โครงสร้างสังกัด

GET /hierarchy โครงสร้าง tree: เขต → กฟจ. → จุดรวมงาน → สาขา
curl "https://namepeaapi.pages.dev/api/v1/hierarchy"

6. Export CSV / JSON

GET /export/offices ดาวน์โหลดข้อมูลทั้งหมดเป็น CSV หรือ JSON
ชื่อค่าคำอธิบาย
format requiredcsv, jsonรูปแบบไฟล์
q, size, group8, groupCodestringfilter เหมือน /offices
# CSV (Excel-compatible, UTF-8 BOM)
curl -o offices.csv "https://namepeaapi.pages.dev/api/v1/export/offices?format=csv"

# JSON
curl -o offices.json "https://namepeaapi.pages.dev/api/v1/export/offices?format=json"

# พร้อม filter
curl -o filtered.csv "https://namepeaapi.pages.dev/api/v1/export/offices?format=csv&size=L"

Response Format

ทุก endpoint ตอบ JSON ในรูปแบบเดียวกัน:

{
  "success": true,
  "data": { ... },        // ข้อมูล
  "meta": {               // pagination / stats
    "total": 116,
    "page": 1,
    "limit": 50
  },
  "error": null            // null ถ้าสำเร็จ
}

// กรณี error:
{
  "success": false,
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "Office not found: XXX"
  }
}

⚡ ข้อจำกัดและหมายเหตุ

PEA Data Retrieval API v1 — Cloudflare Pages