Get Country List

ดึงรายการประเทศทั้งหมดที่มีในระบบ สำหรับใช้เลือกประเทศในส่วนต่างๆ เช่น ข้อมูลที่อยู่ของพนักงาน หรือข้อมูลสัญชาติ

Endpoint


GET /api/v1/open-apis/organization/get-list-country

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ กลุ่มข้อมูลองค์กร (org:manage)

Request Parameters

ไม่มี parameters

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "country_id": "219",
      "country_code": "TH",
      "country_name": "ไทย",
      "country_name_en": "Thailand",
      "country_short_code": "TH"
    }
  ]
}

Error Response (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Error message here"
}

Response Fields

Field	Type	Description
`country_id`	string	รหัสประเทศในระบบ
`country_code`	string	รหัสประเทศ
`country_name`	string	ชื่อประเทศ (ภาษาไทย)
`country_name_en`	string	ชื่อประเทศ (ภาษาอังกฤษ)
`country_short_code`	string \| null	รหัสย่อของประเทศ

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-country" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-country',
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
const countries = data.payload

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-country"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
 
response = requests.get(url, headers=headers)
countries = response.json()['payload']

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-country";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
$countries = $data['payload'];
curl_close($ch);
?>

Notes

รายการจะถูกเรียงตามลำดับ order_no ที่ตั้งไว้ในระบบ
ฟิลด์ country_name เป็นชื่อภาษาไทยเสมอ และ country_name_en เป็นชื่อภาษาอังกฤษเสมอ
country_short_code อาจเป็น null สำหรับประเทศที่ไม่มีรหัสย่อในระบบ
ถ้าไม่มีข้อมูล payload จะเป็น array ว่าง []

Get Title Names - ดึงรายการคำนำหน้าชื่อ
Add Employee - เพิ่มพนักงานพร้อมข้อมูลสัญชาติ/ที่อยู่