Export Visa Certificate PDF

สร้างและดาวน์โหลดไฟล์ PDF ของเอกสารหนังสือรับรองเพื่อยื่นขอวีซ่า รองรับทั้งโหมด Inline บนเบราว์เซอร์ และดึงเป็นไฟล์ PDF

เอกสาร PDF จะแสดงข้อมูลตามภาษาที่ตั้งค่าไว้ (doc_language) พร้อมลายเซ็นผู้อนุมัติ (หากเอกสารได้รับการอนุมัติแล้ว)

Endpoint


GET /api/v1/open-apis/visa-certificate/export
POST /api/v1/open-apis/visa-certificate/export

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`visa_certificate_letter_id`	string (base64)	Yes	รหัสเอกสาร (Base64 encoded)	`"MjAyNjAzMTJWQzAwMDAwMDAwMQ=="`
`authorize_id`	string (base64)	Yes	รหัสผู้ส่งคำขอ (Base64 encoded)	`"YOUR_AUTHORIZE_ID_BASE64"`

Optional Parameters

Parameter	Type	Required	Description	Example
`output`	string	No	โหมดการดึงไฟล์: `"I"` (Inline ดูสดผ่านเบราว์เซอร์), `"F"` (ดึงเป็นไฟล์ URL) ค่าเริ่มต้น: `"F"`	`"F"`
`is_mobile`	boolean	No	ระบุว่าเป็นแอปมือถือ ค่าเริ่มต้น: `false`	`true`
`document_header`	string	No	โครงสร้างที่ต้องการแสดงบน Header PDF	`"branch"`

Response Format

Success Response - File Mode (HTTP 200)


{
  "code": 200,
  "message": "success",
  "payload": "https://example.com/exports/visa-certificate-document.pdf"
}

Success Response - Mobile Mode (HTTP 200)


{
  "code": 200,
  "message": "Success",
  "payload": {
    "visa_certificate_letter_id": "20260312VC000000001",
    "employee_id": "20260309462FEF65EFCA",
    "document_flow_lv": "02",
    "file_pdf": "https://example.com/exports/visa-certificate-document.pdf"
  }
}

Success Response - Inline Mode

เมื่อใช้ output=I ระบบจะส่งไฟล์ PDF โดยตรงผ่าน Content-Type application/pdf ให้เบราว์เซอร์เปิดดูทันที

Error Response - Not Found (HTTP 404)


{
  "code": 404,
  "message": "Error: Certificate not found"
}

Response Fields

Field	Type	Description
`payload` (File mode)	string	URL สำหรับดาวน์โหลดไฟล์ PDF
`visa_certificate_letter_id` (Mobile mode)	string	รหัสเอกสาร
`employee_id` (Mobile mode)	string	รหัสพนักงาน
`document_flow_lv` (Mobile mode)	string	สถานะเอกสาร
`file_pdf` (Mobile mode)	string	URL สำหรับดาวน์โหลดไฟล์ PDF

Code Examples

cURL


# File Mode (output=F)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/export?visa_certificate_letter_id=MjAyNjAzMTJWQzAwMDAwMDAwMQ==&authorize_id=YOUR_AUTHORIZE_ID_BASE64&output=F" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# Inline Mode (output=I)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/export?visa_certificate_letter_id=MjAyNjAzMTJWQzAwMDAwMDAwMQ==&authorize_id=YOUR_AUTHORIZE_ID_BASE64&output=I" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  visa_certificate_letter_id: 'MjAyNjAzMTJWQzAwMDAwMDAwMQ==',
  authorize_id: 'YOUR_AUTHORIZE_ID_BASE64',
  output: 'F'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/export?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('PDF URL:', data.payload)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/export"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "visa_certificate_letter_id": "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "authorize_id": "YOUR_AUTHORIZE_ID_BASE64",
    "output": "F"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
if data["code"] == 200:
    print("PDF URL:", data["payload"])
else:
    print("Error:", data.get("message"))

PHP


<?php
$params = http_build_query([
    "visa_certificate_letter_id" => "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "authorize_id" => "YOUR_AUTHORIZE_ID_BASE64",
    "output" => "F"
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/export?" . $params;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "PDF URL: " . $data['payload'] . "\n";
} else {
    echo "Error: " . $data['message'];
}
 
curl_close($ch);
?>

Notes

ข้อกำหนดสำคัญ:

visa_certificate_letter_id ต้องเข้ารหัส Base64
เอกสาร PDF จะแสดงภาษาตาม doc_language ที่ตั้งค่าไว้ตอนสร้างเอกสาร
หากเอกสารได้รับการอนุมัติแล้ว ลายเซ็นผู้อนุมัติจะถูกแสดงใน PDF อัตโนมัติ
URL ของไฟล์ PDF มีอายุจำกัด ควรดาวน์โหลดทันทีหลังได้รับ URL

Approve - อนุมัติเอกสารก่อนส่งออก PDF
Get Detail - ดูรายละเอียดเอกสารก่อนส่งออก