Export Work Certificate PDF

สร้างไฟล์ PDF ของเอกสารหนังสือรับรองการทำงาน รองรับทั้งการแสดงผลแบบ Inline และการดาวน์โหลดไฟล์

รองรับ 2 โหมด: แสดงผลในเบราว์เซอร์ (output=I) และดาวน์โหลดไฟล์ (output=F) หนังสือรับรองการทำงาน ไม่มีข้อมูลเงินเดือน ใน PDF

Endpoint


GET /api/v1/open-apis/work-certificate/export

หรือ


POST /api/v1/open-apis/work-certificate/export

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`work_certificate_letter_id`	string (base64)	Yes	รหัสเอกสาร (base64 encoded)	`"MjAyNjAzMDVXQzAwMDAwMDAwMQ=="`
`authorize_id`	string (base64)	Yes	รหัสผู้อนุมัติ (base64 encoded)	`"MjAyNTA0..."`

Optional Parameters

Parameter	Type	Default	Description	Example
`output`	string	`"I"`	โหมด output: `"I"` (Inline/เปิดในเบราว์เซอร์), `"F"` (File/ดาวน์โหลด)	`"F"`
`is_mobile`	string	`"false"`	ระบุ platform: `"true"` สำหรับ Mobile	`"true"`
`document_header`	string	`"branch"`	ระบุหัวข้อเอกสาร	`"branch"`

Response Format

Success Response - File Mode (HTTP 200)


{
  "code": 200,
  "message": "success",
  "payload": "https://example.com/exporting/abc123def456.pdf"
}

Success Response - Mobile Mode (HTTP 200)


{
  "code": 200,
  "message": "Success",
  "payload": {
    "work_certificate_letter_id": "20260305WC000000001",
    "employee_id": "20260309462FEF65EFCA",
    "document_flow_lv": "02",
    "file_pdf": "https://example.com/exporting/abc123def456.pdf"
  }
}

เมื่อ output=I (Inline) API จะ stream PDF โดยตรงในเบราว์เซอร์ ไม่ใช่ JSON response

Error Response - Validation Failed (HTTP 400)


{
  "code": 400,
  "message": "Validation failed: 'work_certificate_letter_id' is required"
}

Error Response - Certificate Not Found (HTTP 404)


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

Response Fields

File Mode (`output=F`)

Field	Type	Nullable	Description
`payload`	string	No	URL ของไฟล์ PDF

Mobile Mode (`is_mobile=true`)

Field	Type	Nullable	Description
`work_certificate_letter_id`	string	No	รหัสเอกสาร (plain text)
`employee_id`	string	No	รหัสพนักงาน
`document_flow_lv`	string	No	สถานะเอกสาร
`file_pdf`	string	No	URL ของไฟล์ PDF

Code Examples

cURL


# ดาวน์โหลดไฟล์ PDF (File Mode)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/export?work_certificate_letter_id=MjAyNjAzMDVXQzAwMDAwMDAwMQ==&authorize_id=MjAyNTA0&output=F" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# แสดง PDF ในเบราว์เซอร์ (Inline Mode)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/export?work_certificate_letter_id=MjAyNjAzMDVXQzAwMDAwMDAwMQ==&authorize_id=MjAyNTA0&output=I" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# สร้าง PDF สำหรับ Mobile
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/export?work_certificate_letter_id=MjAyNjAzMDVXQzAwMDAwMDAwMQ==&authorize_id=MjAyNTA0&is_mobile=true" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  work_certificate_letter_id: 'MjAyNjAzMDVXQzAwMDAwMDAwMQ==',
  authorize_id: 'MjAyNTA0',
  output: 'F'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/work-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/work-certificate/export"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
    "authorize_id": "MjAyNTA0",
    "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([
    "work_certificate_letter_id" => "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
    "authorize_id" => "MjAyNTA0",
    "output" => "F"
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-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"];
} else {
    echo "Error: " . $data["message"];
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

work_certificate_letter_id ใน request ต้องเข้ารหัส base64
เมื่อ output=I API จะ stream PDF โดยตรง ไม่ส่ง JSON response
ลายเซ็นใน PDF จะเลือกตามภาษาเอกสาร (doc_language)
ถ้าพนักงานลาออกแล้ว ระบบจะใช้วันที่ลาออกเป็นวันที่สิ้นสุดการทำงานใน PDF

Get Detail - ดูรายละเอียดเอกสารก่อน export
Approve - อนุมัติเอกสารก่อน export (แนะนำ)
Get Signatures - ดูลายเซ็นที่ใช้ได้