APITài liệu tham khảoBáo cáo

Lấy Schema báo cáo

Lấy danh sách các trường, chế độ và bộ lọc khả dụng cho một loại báo cáo.

GETlive.fleetwork.vn/api/v1/workspace/reports/schema

Dùng endpoint này để khám phá các fields khả dụng trước khi gọi Query Report.

Tham số query

reportTypestringBắt buộc
timeline, time-allocation, statistics, job-report, mileage-report
modestringTuỳ chọn
by_user (mặc định) hoặc by_place

Ví dụ

Yêu cầu

Shell

curl -X GET \
  "https://live.fleetwork.vn/api/v1/workspace/reports/schema?reportType=job-report&mode=by_user" \
  -H "API-KEY: <your-key>"

Phản hồi

JSON

{
  "code": "OK",
  "message": null,
  "data": {
    "reportType": "job-report",
    "mode": "by_user",
    "supportedModes": ["by_user", "by_place"],
    "supportedFilters": ["fromTime", "toTime", "userId", "placeId"],
    "fields": [
      {
        "field": "taskName",
        "label": "Tên nhiệm vụ",
        "engLabel": "Task Name",
        "dataType": "string",
        "isDefault": true
      },
      {
        "field": "status",
        "label": "Trạng thái",
        "engLabel": "Status",
        "dataType": "int",
        "isDefault": true
      },
      {
        "field": "completedAt",
        "label": "Hoàn thành lúc",
        "engLabel": "Completed At",
        "dataType": "datetime",
        "isDefault": false
      }
    ]
  }
}

Dùng các giá trị field từ phản hồi làm mảng fields trong Query Report.