Get Signatures

ดึงรายการลายเซ็นที่ใช้ในเอกสารหนังสือรับรองการทำงาน

ลายเซ็นมีทั้งภาษาไทยและอังกฤษ ระบบจะเลือกใช้ตาม doc_language ของเอกสาร ลายเซ็นจะถูกกำหนดให้เอกสารอัตโนมัติเมื่ออนุมัติผ่าน Approve API

Endpoint


GET /api/v1/open-apis/work-certificate/get-signatures

Request Parameters

ไม่มี parameter เพิ่มเติม

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "signature_id": "20260309SIG00000001",
      "employee_id": "20240101APPROVER001",
      "approver_name": "สมชาย ผู้จัดการ",
      "approver_name_en": "Somchai Manager",
      "position_name": "ผู้จัดการฝ่ายบุคคล",
      "position_name_en": "HR Manager",
      "file_name": "signature_somchai.png",
      "file_size": "15000",
      "file_path": "uploads/signatures/signature_somchai.png",
      "file_name_en": "signature_somchai_en.png",
      "file_size_en": "14500",
      "file_path_en": "uploads/signatures/signature_somchai_en.png"
    }
  ]
}

Empty Result Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": []
}

Error Response - Server Error (HTTP 500)


{
  "code": 500,
  "message": "เกิดข้อผิดพลาดของระบบ",
  "error": "Error message"
}

Response Fields

Field	Type	Nullable	Description
`signature_id`	string	No	รหัสลายเซ็น (plain text)
`employee_id`	string	No	รหัสพนักงานเจ้าของลายเซ็น
`approver_name`	string	No	ชื่อผู้อนุมัติ (ภาษาไทย)
`approver_name_en`	string	Yes	ชื่อผู้อนุมัติ (ภาษาอังกฤษ)
`position_name`	string	Yes	ตำแหน่ง (ภาษาไทย)
`position_name_en`	string	Yes	ตำแหน่ง (ภาษาอังกฤษ)
`file_name`	string	Yes	ชื่อไฟล์ลายเซ็น (TH)
`file_size`	string	Yes	ขนาดไฟล์ (bytes)
`file_path`	string	Yes	path ไฟล์ลายเซ็น (TH)
`file_name_en`	string	Yes	ชื่อไฟล์ลายเซ็น (EN)
`file_size_en`	string	Yes	ขนาดไฟล์ (EN)
`file_path_en`	string	Yes	path ไฟล์ลายเซ็น (EN)

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-signatures" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-signatures',
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  data.payload.forEach(sig => {
    console.log('ลายเซ็น:', sig.approver_name, '-', sig.position_name)
  })
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-signatures"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
 
response = requests.get(url, headers=headers)
data = response.json()
 
if data["code"] == 200:
    for sig in data["payload"]:
        print(f"ลายเซ็น: {sig['approver_name']} - {sig['position_name']}")
else:
    print("Error:", data.get("message"))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-signatures";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$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) {
    foreach ($data["payload"] as $sig) {
        echo "ลายเซ็น: " . $sig["approver_name"] . " - " . $sig["position_name"] . "\n";
    }
} else {
    echo "Error: " . $data["message"];
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

ฟิลด์ _id ใน response เป็น plain text
ลายเซ็นจะถูกกำหนดให้เอกสารอัตโนมัติเมื่ออนุมัติผ่าน Approve API
แสดงเฉพาะลายเซ็นที่เผยแพร่แล้ว เรียงลำดับตามชื่อผู้อนุมัติ (A-Z)
file_path อาจเป็น path ภายในหรือ URL เต็ม (https://)

Approve - ลายเซ็นจะถูกกำหนดอัตโนมัติเมื่ออนุมัติขั้นสุดท้าย
Export PDF - ลายเซ็นจะแสดงใน PDF ที่สร้าง