Import Visa Certificate (Bulk)
นำเข้าเอกสารขอหนังสือรับรองเพื่อขอวีซ่าจำนวนมากพร้อมกัน (Bulk Import) ผ่าน JSON Array
ระบบจะตรวจสอบความถูกต้องของข้อมูลทั้งหมดก่อน รายการที่ถูกต้องจะถูกส่งไปประมวลผลในเบื้องหลัง รายการที่ผิดพลาดจะถูกแจ้งกลับพร้อม index และรายละเอียดข้อผิดพลาด
Endpoint
POST /api/v1/open-apis/visa-certificate/importRequest Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
import_data | array | Yes | ชุดข้อมูลรายการเอกสารนำเข้า | ดูโครงสร้างด้านล่าง |
โครงสร้างข้อมูลใน import_data
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
passport_no | string | Yes | หมายเลขพาสปอร์ต | "AA1234567" |
country_visit | string | Yes | ประเทศที่จะเดินทาง | "Japan" |
travel_start_dt | string | Yes | วันที่เริ่มเดินทาง (YYYY-MM-DD) | "2026-04-10" |
travel_end_dt | string | Yes | วันที่สิ้นสุดการเดินทาง (YYYY-MM-DD) | "2026-04-15" |
request_purpose | string | Yes | วัตถุประสงค์การขอ | "ท่องเที่ยว" |
send_doc_address | string | Yes | สถานที่จัดส่งเอกสาร/สถานทูต | "Embassy of Japan" |
doc_language | string | Yes | ภาษาบนเอกสาร (TH หรือ EN) | "EN" |
return_dt | string | No | วันที่เดินทางกลับ (YYYY-MM-DD) | "2026-04-16" |
publish_flag | string | No | เผยแพร่เอกสาร (Y / N) | "Y" |
Response Format
Success Response - All Valid (HTTP 200)
{
"code": 200,
"message": "Successfully enqueued for processing",
"payload": {
"valid_items_count": 1,
"invalid_items": []
}
}Success Response - Partial (HTTP 200)
{
"code": 200,
"message": "Successfully enqueued for processing",
"payload": {
"valid_items_count": 0,
"invalid_items": [
{
"index": 0,
"data": {
"employee_code": "999999",
"doc_language": "TH"
},
"errors": ["Employee not found: '999999'", "Missing 'request_purpose'"]
}
]
}
}Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": ["No valid data to import"]
}Response Fields
| Field | Type | Description |
|---|---|---|
valid_items_count | number | จำนวนรายการที่ถูกต้องและส่งไปประมวลผล |
invalid_items | array | รายการที่ไม่ถูกต้องพร้อมรายละเอียดข้อผิดพลาด |
invalid_items[].index | number | ลำดับ index ของรายการที่ผิดพลาด |
invalid_items[].data | object | ข้อมูลบางส่วนของรายการที่ผิดพลาด |
invalid_items[].errors | array | รายการข้อผิดพลาด |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/import" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"import_data": [
{
"employee_code": "EMP001",
"passport_no": "AA1234567",
"country_visit": "Japan",
"travel_start_dt": "2026-04-10",
"travel_end_dt": "2026-04-15",
"return_dt": "2026-04-16",
"request_purpose": "For tourist visa application",
"send_doc_address": "Embassy of Japan, Bangkok",
"doc_language": "EN"
}
]
}'Notes
ข้อกำหนดสำคัญ:
import_dataต้องเป็น Array อย่างน้อย 1 รายการemployee_codeต้องเป็นรหัสพนักงานที่มีอยู่ในระบบtravel_end_dtต้องมากกว่าหรือเท่ากับtravel_start_dt- รายการที่ถูกต้องจะถูกส่งไปประมวลผลในเบื้องหลัง (Async) เสมือนการเรียก Submit ทีละรายการ
- รายการที่ผิดพลาดจะถูกแจ้งกลับพร้อม index ช่วยให้ตรวจสอบได้ง่าย
Related APIs
Last updated on