Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Report Result

รับลิงก์ดาวน์โหลดไฟล์รายงานเมื่องานสร้างเสร็จแล้ว (status: DONE)

เรียก API นี้หลังจาก Report Status แสดงสถานะ DONE ระบบจะคืนลิงก์ดาวน์โหลดแบบมีอายุจำกัดพร้อมเวลาหมดอายุ (expires_at)

Endpoint

GET /api/v1/open-apis/report-builder/reports/{traceId}/result

Request Parameters

Path Parameters

ParameterTypeRequiredDescriptionExample
traceIdstringYesรหัสติดตามงานที่ได้จาก Submit Report0190f8a1-2b3c-7def-8123-456789abcdef

ลิงก์ใน url มีอายุจำกัด (ดูเวลาหมดอายุที่ expires_at) ระบบจะสร้างลิงก์ใหม่ทุกครั้งที่เรียก API นี้ — หากลิงก์หมดอายุ ให้เรียก API นี้ซ้ำเพื่อรับลิงก์ใหม่ ไม่จำเป็นต้องสร้างรายงานใหม่


Code Examples

# 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

FieldTypeDescription
trace_idstringรหัสติดตามงาน
file.namestringชื่อไฟล์รายงาน
file.sizeintegerขนาดไฟล์ (byte)
file.content_typestringMIME type ของไฟล์
file.urlstringลิงก์ดาวน์โหลดแบบมีลายเซ็นและมีอายุจำกัด
file.expires_atstring (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)
403trace_id เป็นของผู้เช่ารายอื่น (JOB_FORBIDDEN)
404ไม่พบงานตาม trace_id ที่ระบุ หรือหมดอายุแล้ว (JOB_NOT_FOUND)
409งานยังไม่เสร็จ — สถานะยังไม่ใช่ DONE (JOB_NOT_READY)
422งานสร้างรายงานล้มเหลว — สถานะเป็น FAILED (JOB_FAILED)
500เกิดข้อผิดพลาดระหว่างประมวลผลบนเซิร์ฟเวอร์

  • Submit Report - ส่งคำขอสร้างรายงาน
  • Report Status - ตรวจสอบสถานะงาน
Last updated on