GET STARTED

วิธีการใช้งาน API

คู่มือเริ่มต้นตั้งแต่การรับสิทธิ์ใช้งาน ไปจนถึงการเรียกใช้ DDCE API อย่างปลอดภัย

เริ่มต้นใช้งานด้วยบัญชีที่ได้รับอนุมัติ

ทำตามขั้นตอนต่อไปนี้เพื่อรับข้อมูลสำหรับเชื่อมต่อ API

1
ตรวจสอบอีเมลแจ้งผลการอนุมัติคำขอใช้งานระบบ
เมื่อคำขอได้รับอนุมัติ ผู้ขอใช้งานจะได้รับอีเมลแจ้งผลจาก noreply.im-ddce@ddc.mail.go.th
2
เข้าสู่ระบบผ่านเว็บไซต์
เข้าสู่ระบบด้วยบัญชีที่ได้รับอนุมัติ เพื่อจัดการบริการ API ของหน่วยงาน
3
เข้าหน้า “รายการคำขอ API”
เลือกรายการ API ที่ได้รับการอนุมัติใช้งาน แล้วกดปุ่ม “ดู API Key”
4
ยืนยันตัวตนด้วยรหัสยืนยัน 6 หลัก (OTP Code)
ระบบส่งรหัสยืนยันไปยังอีเมลที่ใช้ยื่นคำขอ ตรวจสอบและกรอกรหัสให้ถูกต้อง
5
รับข้อมูลสำหรับการเชื่อมต่อ API
หลังยืนยันสำเร็จ ระบบจะแสดง API URL, Client Key และ Secret Key สำหรับเชื่อมต่อข้อมูล

หมายเหตุ: การพิจารณาคำขอใช้บริการอาจใช้เวลา 7–15 วันทำการ ขึ้นอยู่กับความครบถ้วนของข้อมูลและเอกสารที่ส่ง

แนวทางการใช้งาน API

ใช้ข้อมูลที่ได้รับจากระบบในการเรียกดูข้อมูลตามสิทธิ์ของหน่วยงาน

1 ระบุ URL ของ API ที่ได้รับ

ใช้ URL ที่ได้รับจากหน่วยงานหรือระบบต้นทาง เช่น

https://api.example.com/v1/resource

2 กำหนด Method เป็น GET

ใช้คำสั่ง GET สำหรับเรียกดูหรือดึงข้อมูลจาก API โดยไม่ต้องส่งข้อมูลในส่วนของ Body

3 แนบ Header สำหรับยืนยันตัวตน

ต้องแนบค่าการยืนยันตัวตนและประเภทข้อมูลในรูปแบบต่อไปนี้

Header name	Description	Example value
x-client-key	รหัส Client Key ของผู้ใช้งาน	your-client-key
x-secret-key	รหัส Secret Key ของผู้ใช้งาน	your-secret-key
Content-Type	ประเภทข้อมูลที่ส่งหรือรับ	application/json

Header name

Description

Example value

x-client-key

รหัส Client Key ของผู้ใช้งาน

your-client-key

x-secret-key

รหัส Secret Key ของผู้ใช้งาน

your-secret-key

Content-Type

ประเภทข้อมูลที่ส่งหรือรับ

application/json

4 ตัวอย่างการใช้งานด้วย cURL

curl -X GET "https://api.example.com/v1/resource" \  -H "x-client-key: your-client-key" \  -H "x-secret-key: your-secret-key" \  -H "Content-Type: application/json"

ตัวอย่างการเรียกผ่าน JavaScript (Fetch API)

fetch("https://api.example.com/v1/resource", {
  method: "GET",
  headers: {
    "x-client-key": "your-client-key",
    "x-secret-key": "your-secret-key",
    "Content-Type": "application/json"
  }
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

ขอลิงก์เพื่อเข้าถึงไฟล์

Generate File Access Link สำหรับเปิดไฟล์แนบที่ได้จาก API อย่างปลอดภัย

1 ระบุ URL สำหรับขอลิงก์ไฟล์GET https://api.example.com/api/generate-link

2 กำหนดพารามิเตอร์ที่ต้องส่ง

Parameter	Description	Example
filename	ชื่อไฟล์ที่ต้องการเปิด	abc.pdf
event	รหัสเหตุการณ์จาก API	1234

Parameter

Description

Example

filename

ชื่อไฟล์ที่ต้องการเปิด

abc.pdf

event

รหัสเหตุการณ์จาก API

1234

3 แนบพารามิเตอร์และ Header

GET https://api.example.com/api/generate-link?filename=abc.pdf&event=1234

x-client-key: your-client-key
x-secret-key: your-secret-key
Content-Type: application/json

4 เปิดไฟล์ด้วย URL ที่ได้รับ

ระบบจะตอบกลับ token สำหรับสร้างลิงก์ไฟล์ โดยลิงก์นี้ไม่จำเป็นต้องแนบ Authentication Header ซ้ำ

ข้อควรทราบ: ลิงก์สำหรับเข้าถึงไฟล์มีอายุไม่เกิน 15 นาที และไม่ควรส่งต่อ token ให้ผู้อื่น