Search Projects - Gofive OpenAPI

ค้นหาโปรเจกต์สำหรับลงเวลา

ค้นหาโปรเจกต์ที่ลงเวลาได้ใน tenant ของผู้เรียก ใช้ก่อนบันทึกเวลาเพื่อให้ได้ ProjectCode ที่ถูกต้อง
ผลลัพธ์บอกด้วยว่าโปรเจกต์นั้นกำหนดผู้รับผิดชอบแบบไหน (AssignmentType) และมีช่วงเวลาโปรเจกต์หรือไม่
ทุก field ใน body ไม่บังคับ แต่ ต้องส่ง body มา (ส่ง {} ได้)

⚠️ ข้อควรรู้

ไม่ส่ง body เลยจะได้ 400 จาก framework ในรูปแบบ ValidationProblemDetails ซึ่งไม่ใช่ envelope BffApiResult ของ endpoint นี้

ไม่พบข้อมูลจะได้ 200 พร้อม Data เป็น array ว่าง

🔐 ต้องมีสิทธิ์ Open API โมดูล TimeSheet ระดับ Read

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

ค้นหาด้วยคำค้นเอาทั้งหมดตามค่าเริ่มต้น

{
    "Q": "โปรเจกต์ตัวอย่าง",
    "Limit": 20,
    "IncludeInactive": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

ค้นหาสำเร็จ — Data เป็นรายการโปรเจกต์ที่ตรงคำค้น (เป็น array ว่างเมื่อไม่พบ)

Bodyapplication/json

Example

{
    "Status": {
        "Code": "200",
        "Description": "OK"
    },
    "Data": [
        {
            "ProjectCode": "PRJ-001",
            "ProjectName": "โปรเจกต์ตัวอย่าง หนึ่ง",
            "ProjectStatus": "Active",
            "AssignmentType": "Specific",
            "Assignees": [
                {
                    "EmployeeCode": "EMP001",
                    "EmployeeName": "พนักงานตัวอย่าง หนึ่ง"
                }
            ],
            "HasProjectPeriod": true,
            "StartDate": "2026-01-01",
            "EndDate": "2026-12-31",
            "HasAccountingInfo": true,
            "AccountCode": "ACC-001"
        },
        {
            "ProjectCode": "PRJ-002",
            "ProjectName": "โปรเจกต์ตัวอย่าง สอง",
            "ProjectStatus": "Active",
            "AssignmentType": "All",
            "HasProjectPeriod": false,
            "HasAccountingInfo": false
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error