💧 Water Bill OCR
1 ICต่อหน้า
ยินดีต้อนรับสู่ Water Bill OCR API ซึ่งเป็นส่วนหนึ่งของ iApp Any Documents OCR โดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด แยกข้อมูลใบแจ้งหนี้จากใบแจ้งค่าน้ำของการประปานครหลวง (MWA) และการประปาส่วนภูมิภาค (PWA) รวมถึงการอ่านมิเตอร์, ปริมาณการใช้ และภาษีมูลค่าเพิ่ม จำนวนเงินจะถูกตรวจสอบความถูกต้องทางคณิตศาสตร์ (ยอดรวมย่อย + ภาษีมูลค่าเพิ่ม = ยอดรวม) เพื่อความน่าเชื่อถือบนภาพคุณภาพต่ำ
ลองใช้งาน Demo!
ทดลองใช้ AI Demo
เข้าสู่ระบบหรือสร้างบัญชีฟรีเพื่อใช้งาน AI Demo และสำรวจ API ที่ทรงพลังของเรา
รับ 50 เครดิตฟรี (IC) เมื่อสมัครสมาชิก!
โปรโมชันหมดเขต 31 ธันวาคม 2568
เริ่มต้นใช้งาน
-
ข้อกำหนดเบื้องต้น
- API key จาก ไอแอพพ์เทคโนโลยี
- ไฟล์เอกสาร: ใบแจ้งค่าน้ำ (ใบแจ้งค่าน้ำประปา)
- รูปแบบไฟล์ที่รองรับ: PDF, JPG, JPEG, PNG, WEBP
- ขนาดไฟล์สูงสุด: 50MB
-
เริ่มต้นใช้งานอ ย่างรวดเร็ว
POSTครั้งเดียวพร้อมmultipart/form-data- ผลลัพธ์ JSON ที่มีโครงสร้าง, พร้อมคะแนนความเชื่อมั่นต่อฟิลด์
- แต่ละหน้าอินพุตจะส่งคืนรายการของตัวเองใน
docs, ดังนั้นสามารถส่งเอกสารหลายชุดในคำขอเดียว
-
คุณสมบัติหลัก
- การแยกข้อมูลตามฟิลด์พร้อมคะแนนความเชื่อมั่น
- ผลลัพธ์ภาษาไทยและอังกฤษผ่าน
target_lang - ข้อความ OCR ดิบแบบเลือกได้ผ่าน
return_ocr - รองรับภาพถ่ายและ PDF ที่สแกน
-
ความปลอดภัยและการปฏิบัติตามข้อกำหนด
- เป็นไปตาม GDPR และ PDPA
- จุดเชื่อมต่อ API ที่ปลอดภัย
- ไม่มีข้อมูลคงค้างหลังการประมวลผล
วิธีรับ API Key?
โป รดไปที่หน้า การจัดการ API Key เพื่อดู API key ที่มีอยู่ของคุณ หรือขอใหม่
จุดเชื่อมต่อ API
| จุดเชื่อมต่อ | เมธอด | คำอธิบาย | ราคา |
|---|---|---|---|
/ocr/v3/water-bill/file/v3/store/ocr/water-bill | POST | แยกข้อมูลใบแจ้งหนี้จากใบแจ้งค่าน้ำของไทย (MWA / PWA) | 1 IC ต่อหน้า |
ทั้งสองรูปแบบมีค่าเท่ากัน ไม่มีรูปแบบ base64 สำหรับจุดเชื่อมต่อนี้ — รองรับการอัปโหลดไฟล์เท่านั้น
คำขอ
ส่วนหัวของคำขอ
| ส่วนหัว | ค่า | จำเป็น |
|---|---|---|
apikey | iApp API key ของคุณ | ใช่ |
เนื้อหาของคำขอ (multipart/form-data)
| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
file | ไฟล์ (ทำซ้ำได้) | — | จำเป็น. ไฟล์เอกสาร. หน้า PDF จะถูกประมวลผลโดยอัตโนมัติ |
return_ocr | บูลีน | false | รวมข้อความ OCR ดิบในผลลัพธ์ |
target_lang | สตริง | th | ภาษาของค่าที่แยกได้: th หรือ en |
include_confidence | บูลีน | true | รวมคะแนนความเชื่อมั่นต่อฟิลด์ (0.00–1.00) |
cURL
curl -X POST "https://api.iapp.co.th/ocr/v3/water-bill/file" \
-H "apikey: YOUR_API_KEY" \
-F "file=@/path/to/document.pdf" \
-F "target_lang=th" \
-F "include_confidence=true"
ผลลัพธ์
{
"docs": [
{
"message": "success",
"raw": {},
"processed": {
"provider": "การประปานครหลวง",
"customer_name": null,
"customer_address": "32/14 ม.3 ตำบลท่าจีน อำเภอสามพราน จังหวัดนครปฐม 11130",
"account_number": "67983262",
"invoice_number": "192011-5",
"invoice_date": "12/02/2567",
"current_reading": 606,
"previous_reading": 567,
"consumption_cubic_meter": 39,
"water_usage_charge": 430.39,
"monthly_service_fee": 25.0,
"discount": 0.0,
"subtotal_before_vat": 461.24,
"vat_amount": 32.29,
"total_amount": 493.53,
"due_date": "22/02/2567"
},
"confidence": {
"provider": 0.95,
"customer_name": 0.95,
"customer_address": 0.95,
"account_number": 0.95,
"invoice_number": 0.95,
"invoice_date": 0.95
},
"process_ms": 4120
}
],
"docs_count": 1,
"process_ms": 4300
}
ส่วนหัวการตอบกลับ iapp-input-pages จะรายงานจำนวนหน้าที่ถูกเรียกเก็บเงิน
ฟิลด์ที่รองรับ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| provider | String | หน่วยงานผู้ออก เช่น การประปานครหลวง |
| customer_name | String | ชื่อผู้ใช้น้ำประปา |
| customer_address | String | ที่อยู่บริการ |
| account_number | String | หมายเลขทะเบียนผู้ใช้น้ำประปา |
| invoice_number | String | เลขที่ใบแจ้งหนี้ |
| invoice_date | String | วันที่ออกใบแจ้งหนี้ |
| current_reading | Number | มิเตอร์น้ำปัจจุบัน |
| previous_reading | Number | มิเตอร์น้ำครั้งก่อน |
| consumption_cubic_meter | Number | ปริมาณน้ำที่ใช้ (ลบ.ม.) |
| water_usage_charge | Number | ค่าบริการใช้น้ำ (บาท) |
| monthly_service_fee | Number | ค่าบริการรายเดือน (บาท) |
| discount | Number | ส่วนลด (บาท) |
| subtotal_before_vat | Number | ยอดรวมก่อนภาษีมูลค่าเพิ่ม (บาท) |
| vat_amount | Number | จำนวนภาษีมูลค่าเพิ่ม (บาท) |
| total_amount | Number | ยอดชำระทั้งหมด (บาท) |
| due_date | String | วันที่ครบกำหนดชำระ |
การจัดการข้อผิดพลาด
| สถานะ | ความหมาย |
|---|---|
| 400 | นามสกุลไฟล์ไม่รองรับ หรือไฟล์ใหญ่กว่า 50MB |
| 401 | apikey ขาดหายหรือไม่ถูกต้อง |
| 402 | ยอดคงเหลือเครดิตไม่เพียงพอ |
| 404 | ประเภทเอกสารไม่ทราบใน URL |
| 422 | ไม่มีการแนบไฟล์กับคำขอ |
| 500 | ข้อผิดพลาดในการประมวลผล — ผลลัพธ์มีรหัสข้อผิดพลาดเพื่ออ้างอิงถึงฝ่ายสนับสนุน |
ตัวอย่างโค้ด
Python
import requests
url = "https://api.iapp.co.th/ocr/v3/water-bill/file"
headers = {"apikey": "YOUR_API_KEY"}
files = {"file": open("document.pdf", "rb")}
data = {"target_lang": "th", "include_confidence": "true"}
response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()
print(result["docs"][0]["processed"])
print(result["docs"][0]["confidence"])
JavaScript
const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("target_lang", "th");
form.append("include_confidence", "true");
const res = await fetch("https://api.iapp.co.th/ocr/v3/water-bill/file", {
method: "POST",
headers: { apikey: "YOUR_API_KEY" },
body: form,
});
const result = await res.json();
console.log(result.docs[0].processed);
PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.iapp.co.th/ocr/v3/water-bill/file");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["apikey: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
"file" => new CURLFile("/path/to/document.pdf"),
"target_lang" => "th",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Java
OkHttpClient client = new OkHttpClient();
RequestBody body = new MultipartBody.Builder()
.setType(MultipartBody.FORM)
.addFormDataPart("file", "document.pdf",
RequestBody.create(new File("/path/to/document.pdf"),
MediaType.parse("application/pdf")))
.addFormDataPart("target_lang", "th")
.build();
Request request = new Request.Builder()
.url("https://api.iapp.co.th/ocr/v3/water-bill/file")
.addHeader("apikey", "YOUR_API_KEY")
.post(body)
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.body().string());
}
Swift
let url = URL(string: "https://api.iapp.co.th/ocr/v3/water-bill/file")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
let boundary = UUID().uuidString
request.setValue("multipart/form-data; boundary=\(boundary)",
forHTTPHeaderField: "Content-Type")
var data = Data()
let fileData = try Data(contentsOf: URL(fileURLWithPath: "/path/to/document.pdf"))
data.append("--\(boundary)\r\n".data(using: .utf8)!)
data.append("Content-Disposition: form-data; name=\"file\"; filename=\"document.pdf\"\r\n\r\n".data(using: .utf8)!)
data.append(fileData)
data.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)
URLSession.shared.uploadTask(with: request, from: data) { responseData, _, _ in
if let responseData, let json = String(data: responseData, encoding: .utf8) {
print(json)
}
}.resume()
Kotlin
val client = OkHttpClient()
val body = MultipartBody.Builder()
.setType(MultipartBody.FORM)
.addFormDataPart(
"file", "document.pdf",
File("/path/to/document.pdf").asRequestBody("application/pdf".toMediaType())
)
.addFormDataPart("target_lang", "th")
.build()
val request = Request.Builder()
.url("https://api.iapp.co.th/ocr/v3/water-bill/file")
.addHeader("apikey", "YOUR_API_KEY")
.post(body)
.build()
client.newCall(request).execute().use { response ->
println(response.body?.string())
}
Dart
import 'package:http/http.dart' as http;
final request = http.MultipartRequest(
'POST',
Uri.parse('https://api.iapp.co.th/ocr/v3/water-bill/file'),
);
request.headers['apikey'] = 'YOUR_API_KEY';
request.fields['target_lang'] = 'th';
request.files.add(
await http.MultipartFile.fromPath('file', '/path/to/document.pdf'),
);
final response = await request.send();
print(await response.stream.bytesToString());
ข้อจำกัดและแนวทางปฏิบัติที่ดีที่สุด
ข้อจำกัด
- ขนาดไฟล์สูงสุด 50MB ต่อคำขอ
- รูปแบบที่รองรับ: PDF, JPG, JPEG, PNG, WEBP
- ความแม่นยำขึ้นอยู่กับคุณภาพของภาพ — ภาพสแกนที่เสื่อมสภ าพมาก, แสงสะท้อน และลายมือที่เขียนทับค่าที่พิมพ์ จะลดความแม่นยำของฟิลด์ลง
- การแยกข้อมูลจำกัดเฉพาะฟิลด์ที่ระบุไว้ข้างต้น
แนวทางปฏิบัติที่ดีที่สุด
- เลือกใช้ PDF ต้นฉบับแทนภาพถ่ายหากมี
- ถ่ายภาพเอกสารทั้งหมด โดยให้ตั้งฉากและมีแสงสม่ำเสมอ
- ใช้ความละเอียดอย่างน้อย 300 DPI สำหรับการสแกน
- ตรวจสอบคะแนน
confidenceของแต่ละฟิลด์ และส่งต่อค่าที่มีคะแนนต่ำเพื่อการตรวจสอบด้วยตนเอง - ส่งเอกสารหลายฉบับในคำขอเดียวหากรองรับ เพื่อลดจำนวนรอบการสื่อสาร
ความแม่นยำและประสิทธิภาพ
ความแม่นยำในการแยกข้อมูลตามฟิลด์วัดจากชุดประเมิน ChindaOCR-M3 ภายใน — ป้ายกำกับที่ตรวจสอบด้วยสายตาอีกครั้งบนเอกสารจริงของไทย รวมถึงภาพถ่ายความละเอียดต่ำและใบแจ้งหนี้ที่บางส่วนถูกบดบังด้วยลายมือ
| ประเภทเอกสาร | เอกสาร | ฟิลด์ | ความแม่นยำ |
|---|---|---|---|
| ใบแจ้งค่าน้ำ | 5 | 25 | 100% |
| โดยรวม, ทั้งหกประเภทเอกสาร | 25 | 147 | 98.6% |
การสนับสนุน
ต้องการความช่วยเหลือ? ติดต่อเรา:
- อีเมล: sale@iapp.co.th
- โทรศัพท์: 086-322-5858
- Discord: iApp Technology