OCR รายงานเครดิต NCB

อ่านรายงานข้อมูลเครดิตของเครดิตบูโร แล้วส่งกลับข้อมูลรายงาน ข้อมูลเจ้าของข้อมูล และสรุปรายบัญชีสินเชื่อ

POST/ocr/v3/ncb-credit-report/fileทดลองใช้

• ราคา1 ICต่อหน้า
• ให้บริการแล้ว21.8Kครั้ง

• v1.0
• ใช้งานได้

Input

OutputPOST /ocr/v3/ncb-credit-report/file

report_number

123456789

reference_number

MOBILE_APP-001

query_date

24 ต.ค. 2562 11:09:43

id_card_number

1100000000001

full_name

นาย สมชาย ตัวอย่าง

date_of_birth

11 เม.ย. 2529

total_accounts

6

accounts_under_dispute

0

accounts

lender_name: ธนาคารตัวอย่าง credit_type: สินเชื่อที่อยู่อาศัย account_status: ปกติ credit_limit: 3000000 outstanding_balance: 2500000

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Response

Request

curl -X POST "https://api.iapp.co.th/ocr/v3/ncb-credit-report/file" \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "target_lang=th" \
  -F "include_confidence=true"

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
    "docs": [
        {
            "message": "success",
            "raw": {},
            "processed": {
                        "report_number": "123456789",
                        "reference_number": "MOBILE_APP-001",
                        "query_date": "24 ต.ค. 2562 11:09:43",
                        "id_card_number": "1100000000001",
                        "full_name": "นาย สมชาย ตัวอย่าง",
                        "date_of_birth": "11 เม.ย. 2529",
                        "total_accounts": 6,
                        "accounts_under_dispute": 0,
                        "accounts": [
                                    {
                                                "lender_name": "ธนาคารตัวอย่าง",
                                                "credit_type": "สินเชื่อที่อยู่อาศัย",
                                                "account_status": "ปกติ",
                                                "credit_limit": 3000000,
                                                "outstanding_balance": 2500000
                                    }
                        ]
            },
            "confidence": {
                        "report_number": 0.95,
                        "reference_number": 0.95,
                        "query_date": 0.95,
                        "id_card_number": 0.95,
                        "full_name": 0.95,
                        "date_of_birth": 0.95
            },
            "process_ms": 4120
        }
    ],
    "docs_count": 1,
    "process_ms": 4300
}

Request

ส่งเป็น multipart/form-data เท่านั้น ไม่มีแบบ Base64 ไฟล์ PDF อ่านและคิดเงินทุกหน้า

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

filefilerequired

รายงาน ไฟล์ PDF, JPEG, PNG หรือ WEBP ไม่เกิน 50 MB ส่งซ้ำได้: หลายเอกสารใน Request เดียว

return_ocrboolean

ใส่ true เพื่อรับข้อความ OCR ดิบด้วย

target_langstring

ภาษาของค่าที่แยกได้: th (ค่าเริ่มต้น), en หรือ auto (ใช้ภาษาเดียวกับเอกสาร)

include_confidenceboolean

ค่าเริ่มต้น true: ค่าความมั่นใจ 0.00 ถึง 1.00 รายฟิลด์

/v3/store/ocr/ncb-credit-report คือ Endpoint เดียวกันภายใต้ prefix ของ store

Response

Header iapp-input-pages บอกจำนวนหน้าที่คิดเงิน

docsarray

หนึ่งรายการต่อเอกสารที่อ่าน

docs.processedobject

ฟิลด์ที่อ่านได้จากเอกสาร

docs.processed.report_numberdocs.processed.reference_number

เลขที่รายงานและเลขอ้างอิง

docs.processed.query_datestring

วันและเวลาที่ขอรายงาน

docs.processed.id_card_numberdocs.processed.full_namedocs.processed.date_of_birth

เจ้าของข้อมูล: เลขบัตรประชาชน 13 หลัก ชื่อ และวันเกิด

docs.processed.total_accountsdocs.processed.accounts_under_dispute

จำนวนบัญชีสินเชื่อ และจำนวนที่อยู่ระหว่างโต้แย้ง

docs.processed.accountsarray

บัญชีละหนึ่งรายการ

docs.processed.accounts.lender_namestring

docs.processed.accounts.credit_typestring

docs.processed.accounts.account_statusstring

docs.processed.accounts.credit_limitinteger

docs.processed.accounts.outstanding_balanceinteger

docs.messagestring

ข้อความสถานะ

docs.rawobject

ข้อความ OCR ดิบ เมื่อขอ

docs.confidenceobject

ความมั่นใจรายฟิลด์ 0 ถึง 1

docs.process_msinteger

เวลาที่ใช้ประมวลผล เป็นมิลลิวินาที

docs_countinteger

จำนวนเอกสารที่อ่าน

process_msinteger

เวลาที่ใช้ประมวลผล เป็นมิลลิวินาที

รหัสสถานะ

รหัส	ความหมาย
400	นามสกุลไฟล์ไม่รองรับ หรือไฟล์เกิน 50 MB
404	ชนิดเอกสารใน URL ไม่รู้จัก
422	ไม่มีไฟล์แนบ
500	ประมวลผลผิดพลาด Response มีรหัสไว้แจ้งฝ่ายสนับสนุน

รายละเอียดเพิ่มเติม

ผลการทดสอบ

ความแม่นยำรายฟิลด์ บนชุดประเมินภายในจากเอกสารไทยจริงที่ตรวจเฉลยซ้ำด้วยตา รวมภาพถ่ายความละเอียดต่ำและบิลที่มีลายมือเขียนทับบางส่วน

รายการ	ผล
รายงานเครดิต NCB 5 ฉบับ 19 ฟิลด์	100%
เอกสารทั้งหกชนิด 25 ฉบับ 147 ฟิลด์	98.6%

ข้อจำกัด

• แยกได้เฉพาะฟิลด์ข้างต้น
• ภาพสแกนคุณภาพต่ำ แสงสะท้อน หรือลายมือเขียนทับตัวพิมพ์ ทำให้ความแม่นยำลดลง ควรใช้ PDF ต้นฉบับถ้ามี ภาพถ่ายตรง ๆ ในแสงสม่ำเสมอ หรือภาพสแกน 300 dpi ขึ้นไป และส่งฟิลด์ที่ความมั่นใจต่ำให้คนตรวจ

การจัดการข้อมูล

การขอความยินยอมและการแจ้งเจ้าของข้อมูลตาม PDPA และ GDPR เป็นหน้าที่ของคุณในฐานะผู้ควบคุมข้อมูล