Report Result
รับลิงก์ดาวน์โหลดไฟล์รายงานเมื่องานสร้างเสร็จแล้ว (status: DONE)
เรียก API นี้หลังจาก Report Status แสดงสถานะ DONE ระบบจะคืนลิงก์ดาวน์โหลดแบบมีอายุจำกัดพร้อมเวลาหมดอายุ (expires_at)
Endpoint
GET /api/v1/open-apis/report-builder/reports/{traceId}/resultRequest Parameters
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
traceId | string | Yes | รหัสติดตามงานที่ได้จาก Submit Report | 0190f8a1-2b3c-7def-8123-456789abcdef |
ลิงก์ใน url มีอายุจำกัด (ดูเวลาหมดอายุที่ expires_at) ระบบจะสร้างลิงก์ใหม่ทุกครั้งที่เรียก API นี้ — หากลิงก์หมดอายุ ให้เรียก API นี้ซ้ำเพื่อรับลิงก์ใหม่ ไม่จำเป็นต้องสร้างรายงานใหม่
Code Examples
cURL
# 1) รับลิงก์ดาวน์โหลด
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/report-builder/reports/0190f8a1-2b3c-7def-8123-456789abcdef/result" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
# 2) ดาวน์โหลดไฟล์จาก url ที่ได้ (ลิงก์มีลายเซ็นอยู่แล้ว ไม่ต้องส่ง API Key)
curl -o report.csv "<url-from-response>"Response Format
Success Response (HTTP 200)
{
"trace_id": "0190f8a1-2b3c-7def-8123-456789abcdef",
"file": {
"name": "report.csv",
"size": 20480,
"content_type": "text/csv",
"url": "https://files.humansoft.co.th/reports/0190f8a12b3c.csv?token=...",
"expires_at": "2026-06-17T09:15:00.000Z"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
trace_id | string | รหัสติดตามงาน |
file.name | string | ชื่อไฟล์รายงาน |
file.size | integer | ขนาดไฟล์ (byte) |
file.content_type | string | MIME type ของไฟล์ |
file.url | string | ลิงก์ดาวน์โหลดแบบมีลายเซ็นและมีอายุจำกัด |
file.expires_at | string (ISO 8601) | เวลาที่ลิงก์ดาวน์โหลดหมดอายุ |
Error Responses
Report Not Ready (HTTP 409)
ขอผลลัพธ์ขณะที่งานยังไม่เสร็จ (สถานะยังไม่ใช่ DONE):
{
"error": {
"code": "JOB_NOT_READY",
"message": "Report not ready (status: PROCESSING)"
}
}Report Failed (HTTP 422)
{
"error": {
"code": "JOB_FAILED",
"message": "Report generation failed"
}
}Status Codes
| Code | ความหมาย |
|---|---|
200 | สำเร็จ — คืนลิงก์ดาวน์โหลด |
401 | ไม่ได้ส่ง API Key หรือ Key ไม่ถูกต้อง (UNAUTHORIZED) |
403 | trace_id เป็นของผู้เช่ารายอื่น (JOB_FORBIDDEN) |
404 | ไม่พบงานตาม trace_id ที่ระบุ หรือหมดอายุแล้ว (JOB_NOT_FOUND) |
409 | งานยังไม่เสร็จ — สถานะยังไม่ใช่ DONE (JOB_NOT_READY) |
422 | งานสร้างรายงานล้มเหลว — สถานะเป็น FAILED (JOB_FAILED) |
500 | เกิดข้อผิดพลาดระหว่างประมวลผลบนเซิร์ฟเวอร์ |
Related APIs
- Submit Report - ส่งคำขอสร้างรายงาน
- Report Status - ตรวจสอบสถานะงาน
Last updated on