Get Signatures

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

ลายเซ็นที่แสดงเป็นรายการที่เผยแพร่แล้วเท่านั้น เรียงลำดับตามชื่อผู้อนุมัติ (A-Z) ใช้ signature_id จาก API นี้เป็น parameter ในการอนุมัติขั้นสุดท้าย

Endpoint


GET /api/v1/open-apis/visa-certificate/get-signatures
POST /api/v1/open-apis/visa-certificate/get-signatures

Request Body

ไม่มี parameter เพิ่มเติม นอกเหนือจาก Header ยืนยันตัวตน

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_name_en": "signature_somchai_en.png",
      "file_size_en": "14500"
    }
  ]
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": ["Validation error"]
}

Response Fields

Field	Type	Description
`signature_id`	string	รหัสลายเซ็น (นำไปใช้เป็น parameter ตอนอนุมัติ)
`employee_id`	string	รหัสพนักงานเจ้าของลายเซ็น
`approver_name`	string	ชื่อผู้อนุมัติ (TH)
`approver_name_en`	string	ชื่อผู้อนุมัติ (EN)
`position_name`	string	ตำแหน่งผู้อนุมัติ (TH)
`position_name_en`	string	ตำแหน่งผู้อนุมัติ (EN)
`file_name`	string	ชื่อไฟล์ลายเซ็น (TH)
`file_size`	string	ขนาดไฟล์ลายเซ็น (TH)
`file_name_en`	string	ชื่อไฟล์ลายเซ็น (EN)
`file_size_en`	string	ขนาดไฟล์ลายเซ็น (EN)

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/visa-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/visa-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.signature_id)
    console.log('ผู้อนุมัติ:', sig.approver_name, '/', sig.approver_name_en)
    console.log('ตำแหน่ง:', sig.position_name, '/', sig.position_name_en)
  })
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-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['signature_id']}")
        print(f"ผู้อนุมัติ: {sig['approver_name']} / {sig['approver_name_en']}")
        print(f"ตำแหน่ง: {sig['position_name']} / {sig['position_name_en']}")
else:
    print("Error:", data.get("errors") or data.get("message"))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-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['signature_id']}\n";
        echo "ผู้อนุมัติ: {$sig['approver_name']} / {$sig['approver_name_en']}\n";
        echo "ตำแหน่ง: {$sig['position_name']} / {$sig['position_name_en']}\n";
    }
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['message']);
}
 
curl_close($ch);
?>

Notes

หมายเหตุ:

ระบบจะแสดงเฉพาะลายเซ็นที่เผยแพร่แล้ว โดยเรียงตามชื่อผู้อนุมัติ A-Z อัตโนมัติ
นำ signature_id ที่ได้ไปใช้ใน API Approve เพื่อแนบลายเซ็นในเอกสาร
ลายเซ็นรองรับทั้งภาษาไทยและภาษาอังกฤษ

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