Get Signatures

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

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

Endpoint


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

Request Body

ไม่มี 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 - System Error (HTTP 500)


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

Response Fields

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

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary-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/salary-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) {
  console.log('จำนวนลายเซ็น:', data.payload.length)
  data.payload.forEach(sig => {
    console.log(`${sig.approver_name} - ${sig.position_name}`)
  })
} else {
  console.error('Error:', data.error || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary-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:
    print("จำนวนลายเซ็น:", len(data["payload"]))
    for sig in data["payload"]:
        print(f"{sig['approver_name']} - {sig['position_name']}")
else:
    print("Error:", data.get("error") or data.get("message"))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary-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) {
    echo "จำนวนลายเซ็น: " . count($data['payload']) . "\n";
    foreach ($data['payload'] as $sig) {
        echo $sig['approver_name'] . " - " . $sig['position_name'] . "\n";
    }
} else {
    echo "Error: " . ($data['error'] ?? $data['message']);
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

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

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

Get Signatures

Endpoint

Request Body

Response Format

Success Response (HTTP 200)

Empty Result Response (HTTP 200)

Error Response - System Error (HTTP 500)

Response Fields

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs