# 附件處理
跨模組通用的功能，可管理系統附件，包括：附件上傳、附件下載、附件刪除。
## 附件上傳
> 使用說明，以表單申請要加入附件舉例：\
> \- step1. 打這個 API 取得回傳物件\
> \- step2. 把回傳物件 push 進表單申請的 attachments 陣列\
> 回傳格式：\
> \`\`\`\
> {\
> "fileUUID": "30381c3458faf2d31c38aed42e7c6e17",\
> "fileName": "1.png",\
> "fileSize": 74506,\
> "fileMime": "image/png",\
> "isTmp": 1\
> }\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"附件處理","description":"跨模組通用的功能，可管理系統附件，包括：附件上傳、附件下載、附件刪除。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/file/attach":{"post":{"tags":["附件處理"],"summary":"附件上傳","description":"使用說明，以表單申請要加入附件舉例：\n- step1. 打這個 API 取得回傳物件\n- step2. 把回傳物件 push 進表單申請的 attachments 陣列\n回傳格式：\n```\n{\n \"fileUUID\": \"30381c3458faf2d31c38aed42e7c6e17\",\n \"fileName\": \"1.png\",\n \"fileSize\": 74506,\n \"fileMime\": \"image/png\",\n \"isTmp\": 1\n}\n```\n","requestBody":{"require":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["funCode","attachment"],"properties":{"funCode":{"type":"string","description":"約定的功能代碼，例如：請假單=\"wf010\""},"attachment":{"type":"string","format":"binary","description":"multipart request 的 field name 必須是 'attachment'"}}}}}},"responses":{"200":{"description":"成功"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"450":{"description":"MulterError `{ code: 450, msg?: string }`"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## POST /api/file/detach
> 刪除已上傳的附件
```json
{"openapi":"3.0.0","tags":[{"name":"附件處理","description":"跨模組通用的功能，可管理系統附件，包括：附件上傳、附件下載、附件刪除。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/file/detach":{"post":{"tags":["附件處理"],"summary":"刪除已上傳的附件","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uuid"],"properties":{"uuid":{"type":"string","description":"FILE UUID"}}}}}},"responses":{"200":{"description":"成功"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}}
```
## POST /api/file/download
> 下載附件
```json
{"openapi":"3.0.0","tags":[{"name":"附件處理","description":"跨模組通用的功能，可管理系統附件，包括：附件上傳、附件下載、附件刪除。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/file/download":{"post":{"tags":["附件處理"],"summary":"下載附件","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uuid"],"properties":{"uuid":{"type":"string","description":"FILE UUID"}}}}}},"responses":{"200":{"description":"成功"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://104ha-docs.gitbook.io/104-ha-openapi/clients/104-hr-max/fu-jian-chu-li.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.