Add Employee Attachment - Gofive OpenAPI

แนบเอกสารให้พนักงาน

แนบเอกสารให้พนักงาน 1 คน ครั้งละหลายไฟล์ — แต่ละไฟล์ระบุประเภทเอกสารด้วยรหัสจาก
GET /api/v1/masters/mastersetup/document-type

📋 ต้องมีข้อมูลก่อนเรียก: ประเภทเอกสารที่อ้างถึงต้องถูกตั้งไว้ในระบบแล้ว

⚠️ ข้อควรรู้

ไฟล์ส่งเป็น URL ของไฟล์ที่อัปโหลดไว้แล้ว ไม่ใช่ multipart upload — endpoint นี้รับเฉพาะ application/json

endpoint นี้เป็น เวอร์ชัน 2 (/api/v2/...) ตามที่ระบบให้บริการจริง

ไม่สำเร็จได้ 400 โดยเหตุผลอยู่ใน Data.message

📎 Attachment Limit

จำนวนเอกสารแนบ (Documents) สูงสุดต่อ 1 Request: 20 รายการ

หากส่งเกินจำนวนนี้ ระบบจะตอบกลับ 429 Too Many Requests โดยไม่บันทึกรายการใดเลย

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "EmployeeRefId": "EMP001",
    "CompanyName": "Acme",
    "Documents": [
        {
            "DocumentTypeId": 30201,
            "AttachmentFilename": "id-card-copy.pdf",
            "AttachmentURL": "https://cdn.example.com/employee/id-card-copy.pdf"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

แนบเอกสารสำเร็จ — ผลอยู่ใน Data

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": {
        "result": true,
        "message": "Saved successfully."
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error