---
# System prepended metadata

title: 登革熱防治

---

# 登革熱防治

---
- 常數定義
  - [使用者上傳內容項目類別](#使用者上傳內容項目類別)
- API 清單
  - 共用
    - [取得項目類別列表](#取得項目類別列表)
  - APP端
    - [取得列表](#取得列表)
    - [取得明細](#取得明細)
    - [經緯度查詢地址](#經緯度查詢地址)
    - [取得上傳網址](#取得上傳網址)
    - [取得租戶列表](#取得租戶列表)
    - [新增登革熱防治紀錄](#新增登革熱防治紀錄)
    - [編輯登革熱防治紀錄](#編輯登革熱防治紀錄)
    - [刪除登革熱防治紀錄](#刪除登革熱防治紀錄)
    - [刪除登革熱防治紀錄單一圖片](#刪除登革熱防治紀錄單一圖片)
  - WEB端
    - [取得管理列表](#取得管理列表)
    - [取得管理明細](#取得管理明細)
    - [匯出管理列表](#匯出管理列表)
  
---


## 常數定義
### 使用者上傳內容項目類別
 欄位 | 型態  | 說明  
 ---|---|---
 itemType | string | 使用者上傳內容項目類別, 01: 登革熱防治, 02: 媽媽手冊, 03: 診斷證明書

---
 
# API 清單
## 共用

### 取得項目類別列表
```url
POST /user-content/item-type-list
```

* 權限: 租戶管理員(TENANT_ADMIN), 租戶使用者(TENANT_ROLE_USER), App使用者(GENERAL_PUBLIC) 

#### Request-取得項目類別列表


#### Response-取得項目類別列表
 欄位 | 型態 | 說明 
 ---  | --- | ---
 code | string | 項目類別 code
 description | string | 項目類別說明

```javascript
{
    "httpCode": 200,
    "result": {
        "data": [
            {
                "code": "01",
                "description": "登革熱防治"
            }
        ]
    }
}
```


--- 

## APP端

### 取得列表
```url
POST /user-content/dengue/list
```

* 權限: App使用者(GENERAL_PUBLIC) 

#### Request-取得列表
##### Request-取得列表-query (查詢條件json)
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 targetTenantId | string | | 36 | | 上傳對象租戶id, 未填表示查詢全部
 
##### Request-取得列表-pagination (分頁json)
 欄位 | 型態  | 必填 | 預設 | 說明
 ---|---|---|---|---
 current | int | | 1 | 當前頁數 
 pageSize | int | | 10 | 每頁結果數量，-1 為顯示所有
 
##### Request-取得列表-sorter (排序json) 
 欄位 | 型態  | 必填 | 預設 | 說明
 ---|---|---|---|--- 
 field | string | | recordTime | 排序欄位,可排序欄位有 recordTime
 order | string | | desc | 升序或降序 

```javascript
{
    "query": {
        "targetTenantId": null
    },
     "pagination": {
         "current": 1,
         "total": 1,
         "pageSize": 10
     },
     "sorter": {
         "field": "recordTime",
         "order": "desc"
     }
}
```

#### Response-取得列表
 欄位 | 型態 | 說明 
 ---  | --- | ---
 id | string | 紀錄id
 householdMemberId | string | householdMemberId
 itemType | string | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 targetTenantId | string | 上傳對象租戶id
 targetTenantName | string | 上傳對象租戶名稱
 recordTime | timestamp | 上傳時間
 description | string | 說明
 address | string | 地址
 objectKey | string | 圖檔objectKey(最新一筆)
 url | string | 圖檔可download 的 url, 時效 3600 秒
 createTime | timestamp | 建立時間 
 updateTime | timestamp | 更新時間
  

```javascript
{
    "httpCode": 200,
    "result": {
        "data": [
            {
                "id": "fc00087b-843e-4511-84da-c233b37b5041",
                "householdMemberId": "150b53f5-7126-4900-9fb0-87a08b45e06b",
                "itemType": "01",
                "targetTenantId": "858b7fbb-3ba0-4d49-9882-c893a1ef07dc",
                "recordTime": 1692595800000,
                "createTime": 1692606914905,
                "updateTime": 1692606914905,
                "targetTenantName": "緯緯醫學",
                "description": "TEST description",
                "objectKey": "user-content/dengue/A5555.jpg",
                "url": "http://content-service/swift/v1/user-content/dengue/A5555.jpg",
                "address": "800台灣高雄市新興區中正三路4號"
            }
        ],
        "pagination": {
            "current": 1,
            "pageSize": 10,
            "total": 1
        },
        "sorter": {
            "field": "recordTime",
            "order": "desc"
        },
        "total": 1
    }
}
```


### 取得明細
```url
POST /user-content/dengue/info
```

* 權限: App使用者(GENERAL_PUBLIC) 

#### Request-取得明細
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 id | string | Y | 36 | | 紀錄id

```javascript
{
    "id": "b5c65827-0089-4cb1-8f1e-3b169524da06"
}
```

#### Response-取得明細
 欄位 | 型態 | 說明 
 ---  | --- | ---
 id | string | 紀錄id
 householdMemberId | string | householdMemberId
 itemType | string | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 targetTenantId | string | 上傳對象租戶id
 targetTenantName | string | 上傳對象租戶名稱
 recordTime | timestamp | 上傳時間
 description | string | 說明
 address | string | 地址
 contentObjectList | json array | 上傳內容圖片 json array
 createTime | timestamp | 建立時間 
 updateTime | timestamp | 更新時間

##### Response-取得明細-contentObjectList(json)
 欄位 | 型態 | 說明 
 ---  | --- | ---
 targetId | string | 紀錄id
 objectKey | string | 圖檔objectKey
 url | string | 圖檔可download 的 url, 時效 3600 秒 

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "id": "fc00087b-843e-4511-84da-c233b37b5041",
            "householdMemberId": "150b53f5-7126-4900-9fb0-87a08b45e06b",
            "itemType": "150b53f5-7126-4900-9fb0-87a08b45e06b",
            "targetTenantId": "858b7fbb-3ba0-4d49-9882-c893a1ef07dc",
            "recordTime": 1692595800000,
            "description": "TEST description",
            "createTime": 1692606914905,
            "updateTime": 1692606914905,
            "contentObjectList": [
                {
                    "targetId": "fc00087b-843e-4511-84da-c233b37b5041",
                    "objectKey": "user-content/dengue/A5555.jpg",
                    "createTime": 1692603207000,
                    "updateTime": 1692603207000,
                    "url": "http://content-service/swift/v1/user-content/dengue/A5555.jpg"
                },
                {
                    "targetId": "fc00087b-843e-4511-84da-c233b37b5041",
                    "objectKey": "user-content/dengue/A9999.jpg",
                    "createTime": 1692592235000,
                    "updateTime": 1692592235000,
                    "url": "http://content-service/swift/v1/user-content/dengue/A9999.jpg"
                },
                {
                    "targetId": "fc00087b-843e-4511-84da-c233b37b5041",
                    "objectKey": "user-content/dengue/A0001.jpg",
                    "createTime": 1692583200000,
                    "updateTime": 1692583200000,
                    "url": "http://content-service/swift/v1/user-content/dengue/A0001.jpg"
                }
            ],
            "targetTenantName": "緯緯醫學",
            "address": "800台灣高雄市新興區中正三路4號"
        }
    }
}
```


### 經緯度查詢地址
```url
POST /user-content/dengue/parse-address
```

* 權限: App使用者(GENERAL_PUBLIC) 

#### Request-經緯度查詢地址
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 lat | double | Y |  | | 緯度
 lng | double | Y |  | | 經度

```javascript
{
    "lat": 22.6309192988031,
    "lng": 120.31298575567882
}
```

#### Response-經緯度查詢地址
 欄位 | 型態 | 說明 
 ---  | --- | ---
 lat | double | 緯度
 lng | double | 經度
 address | string | 地址

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "lat": 22.6309192988031,
            "lng": 120.31298575567882,
            "address": "800台灣高雄市新興區中正三路4號"
        }
    }
}
```


### 取得上傳網址
```url
POST /user-content/dengue/get-upload-url
```

* 權限: App使用者(GENERAL_PUBLIC) 
* 新增/編輯紀錄時用來上傳圖片前, 要先取得可上傳圖檔的網址

#### Request-取得上傳網址
 欄位 | 型態  | 必填 | 預設 | 說明 
 ---|---|---|---|---
 isMultipart | boolean | Y | false | 是否使用分段上傳
 isThumbnail | boolean | Y | false | 上傳的是否為縮圖
 fileName    | String | Y | | 檔名，不包含副檔名，限制最多50字
 fileType    | String | Y | | 副檔名, 限制最多10字
 totalPart   | int    | **N** (isMultipart=false)<br>**Y** (isMultipart=true) | | 總分塊數量，不可小於2
 parts       | Array [...part] | **N** (isMultipart=false)<br>**Y** (isMultipart=true) | | part 資訊 

##### Request-取得上傳網址-part(Object)
 欄位 | 型態  | 必填 | 預設 | 說明 
 ---|---|---|---|---
 chunkSize | int | Y | | 該 chunk 的大小, bytes
 md5 | string | Y | | 該 part 的 md5
 part | int | Y | | part number, 第幾塊 chunk

```javascript
// 單檔
{
    isMultipart: false,
    fileName: member_card_test-2,
    fileType: png,
    totalPart: null,
    parts: [
    ],
    isThumbnail: true
}

// 分塊上傳
{
    isMultipart: true,
    isThumbnail: false,
    fileName: giphy (7),
    fileType: mp4,
    totalPart: 2,
    parts: [
    	{
    		chunkSize: 5242880,
    		md5: 5AACA89868CD486D81192221CF9F9415,
    		part: 1
    	},
    	{
    		chunkSize: 3145728,
    		md5: 5AACA89868CD486D81192221CF9F9415,
    		part: 2
    	}
    ]
}
```

#### Error-取得上傳網址
 httpCode | 錯誤碼 | 說明
 --- | --- | ---
 422 | SERVICE_ERROR.UPLOAD_FILE_TYPE_NOT_ALLOWED | 上傳的檔案類型不允許

#### Response-取得上傳網址
##### Response-取得上傳網址-data
 欄位 | 型態 | 說明 
 ---  | --- | ---
 objectKey | string | storage 中的 objectKey, **unique** 
 uploadId | string | 識別該次上傳的 uploadId 
 fileName | string | 名稱 
 fileType | string | 副檔名 
 url | string | 單檔上傳的時候，才會回傳該 url, 時效 3600 秒
 parts | [...part] | multipart上傳各part的url

##### Response-取得上傳網址-part
 欄位 | 型態 | 說明 
 ---  | --- | ---
 chunkSize | int | 該 chunk 的大小, bytes
 md5 | string | 該 part 的 md5
 part | int | part number, 第幾塊 chunk
 url | string | 可上傳的 url, 時效 3600 秒

```javascript
// 單檔
{
    httpCode: 200,
    result: {
        data: {
            objectKey: user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/56ca1cfc-4bcb-4a0a-b079-fd08a0e75a37.png,
            uploadId: fb483648-25d0-4137-bb49-85c17842a95b,
            fileName: member_card_test-2,
            fileType: png,
            url: http://swift-storage/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/56ca1cfc-4bcb-4a0a-b079-fd08a0e75a37.png
        }
    }
}
// 分塊上傳
{
    httpCode: 200,
    result: {
        data: {
            objectKey: event/f76adf26-1e22-4b18-980d-b9a68efc5171.mp4,
            uploadId: 53fde368-43d9-455f-a610-62091fc30be6,
            fileName: giphy (7),
            fileType: mp4,
            parts: [
                {
                    chunkSize: 5242880,
                    md5: 5AACA89868CD486D81192221CF9F9415,
                    part: 1,
                    url: http://swift-storage/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/56ca1cfc-4bcb-4a0a-b079-fd08a0e75a37.png
                },
                {
                    chunkSize: 3145728,
                    md5: 5AACA89868CD486D81192221CF9F9415,
                    part: 2,
                    url: http://swift-storage/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/56ca1cfc-4bcb-4a0a-b079-fd08a0e75a37.png
                }
            ]
        }
    }
}
```


### 取得租戶列表
```url
POST /user-content/dengue/tenant-list
```

* 權限: App使用者(GENERAL_PUBLIC) 

#### Request-取得租戶列表
 

#### Response-取得租戶列表
 欄位 | 型態 | 說明 
 ---  | --- | ---
 tenantId | string | 租戶id
 tenantName | string | 租戶名稱

```javascript
{
    "httpCode": 200,
    "result": {
        "data": [
            {
                "tenantId": "1af0a4c2-ef73-4385-aa8e-8e7ae8afe155",
                "tenantName": "小港醫院"
            },
            {
                "tenantId": "1c21dbc4-09f2-4020-844d-099808ef9da0",
                "tenantName": "緯緯企業"
            },
            {
                "tenantId": "5efcfd67-334e-45b3-bf49-7e52f5172891",
                "tenantName": "企客第一家"
            },
            {
                "tenantId": "858b7fbb-3ba0-4d49-9882-c893a1ef07dc",
                "tenantName": "緯緯醫學"
            },
            {
                "tenantId": "cafc5823-cc3d-4834-b9f8-212c1572414b",
                "tenantName": "旺來醫院"
            }
        ]
    }
}
```


### 新增登革熱防治紀錄
```url
POST /user-content/dengue/add
```
* 權限: App使用者(GENERAL_PUBLIC)

#### Request-新增登革熱防治紀錄
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 targetTenantId | string |  | 36 |  | 上傳對象租戶id
 recordTime | timestamp | Y | | | 上傳時間
 itemType | string | Y | 2 | | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 description | string | | 2000 | | 說明
 address | string |  | 500 | | 地址
 contentObjectList | json array | Y | 10 | | 上傳內容圖片 json array, 最少1張, 最多10張
 
##### Request-新增登革熱防治紀錄-contentObjectList(json)
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 objectKey | string | Y | 500 | | 上傳圖片的objectKey, 先取得圖片的上傳網址並上傳成功，取其 objectKey。
 isMultipart | boolean | N | | | 圖片上傳時是否分塊上傳，預設為 false
 totalPart | int | **N** (isMultipart=false)<br>**Y** (isMultipart=true) | | | 圖片上傳的總分塊數量，不可小於2
 uploadId | string | **N** (isMultipart=false)<br>**Y** (isMultipart=true) | | | 從 /user-content/dengue/get-upload-url 取得的 uploadId
 
```javascript
{
    "targetTenantId": null,
    "recordTime": 1692617732000,
    "itemType": "01",
    "description": "TEST description",
    "address": "800台灣高雄市新興區中正三路4號",
    "contentObjectList": [
        {
            "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/5399c12-c5fd-4a2f-8d8a-641e1c63acea.png",
            "isMultipart": false
        },
        {
            "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/bcee6b4e-856d-41aa-bff3-6aff115006d6.png",
            "isMultipart": false
        }
    ]
}
```

#### Error-新增登革熱防治紀錄
 httpCode | 錯誤碼 | 說明
 --- | --- | ---
 400 | API_ERROR.ARGUMENT_ERROR | 輸入參數錯誤, 可參閱 errorDesc

#### Response-新增登革熱防治紀錄
 欄位 | 型態 | 說明 
 ---  | --- | ---
 id | string | 紀錄id
 householdMemberId | string | householdMemberId
 itemType | string | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 targetTenantId | string | 上傳對象租戶id
 recordTime | timestamp | 上傳時間
 description | string | 說明
 createTime | timestamp | 建立時間 
 updateTime | timestamp | 更新時間

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "id": "b5c65827-0089-4cb1-8f1e-3b169524da06",
            "householdMemberId": "150b53f5-7126-4900-9fb0-87a08b45e06b",
            "itemType": "01",
            "recordTime": 1692617732000,
            "description": "TEST description",
            "createTime": 1692652501808,
            "updateTime": 1692652501808
        }
    }
}
```


### 編輯登革熱防治紀錄
```url
POST /user-content/dengue/update
```
* 權限: App使用者(GENERAL_PUBLIC)

#### Request-編輯登革熱防治紀錄
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 id | string | Y | 36 | | 紀錄id
 targetTenantId | string | | 36 |  | 上傳對象租戶id
 recordTime | timestamp | Y | | | 上傳時間
 itemType | string | Y | 2 | | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 description | string | | 2000 | | 說明
 address | string |  | 500 | | 地址
 contentObjectList | json array | Y | 10 | | 上傳內容圖片 json array, 最少1張, 最多10張
 
##### Request-編輯登革熱防治紀錄-contentObjectList(json)
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 objectKey | string | Y | 500 | | 上傳圖片的objectKey, 先取得圖片的上傳網址並上傳成功，取其 objectKey。
 isMultipart | boolean | N | | | 圖片上傳時是否分塊上傳，預設為 false
 totalPart | int | **N** (isMultipart=false)<br>**Y** (isMultipart=true) | | | 圖片上傳的總分塊數量，不可小於2
 uploadId | string | **N** (isMultipart=false)<br>**Y** (isMultipart=true) | | | 從 /user-content/dengue/get-upload-url 取得的 uploadId
 
```javascript
{
    "id": "b5c65827-0089-4cb1-8f1e-3b169524da06",
    "targetTenantId": null,
    "recordTime": 1692617732000,
    "itemType": "01",
    "description": "TEST description-12345",
    "address": "台灣高雄市新興區中正三路4號",
    "contentObjectList": [
        {
            "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/5399c12-c5fd-4a2f-8d8a-641e1c63acea.png",
            "isMultipart": false
        },
        {
            "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/1e2861b2-939f-4d8a-8e18-6157f10fedf9.png",
            "isMultipart": false
        }
    ]
}
```

#### Error-編輯登革熱防治紀錄
 httpCode | 錯誤碼 | 說明
 --- | --- | ---
 400 | API_ERROR.ARGUMENT_ERROR | 輸入參數錯誤, 可參閱 errorDesc
 422 | SERVICE_ERROR.USER_CONTENT_DENGUE_INFO_NOT_EXIST | 使用者上傳登革熱記錄不存在
 403 | API_ERROR.PERMISSION_DENIED | 無此操作權限

#### Response-編輯登革熱防治紀錄
 欄位 | 型態 | 說明 
 ---  | --- | ---
 id | string | 紀錄id
 householdMemberId | string | householdMemberId
 itemType | string | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 targetTenantId | string | 上傳對象租戶id
 recordTime | timestamp | 上傳時間
 description | string | 說明
 createTime | timestamp | 建立時間 
 updateTime | timestamp | 更新時間

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "id": "b5c65827-0089-4cb1-8f1e-3b169524da06",
            "householdMemberId": "150b53f5-7126-4900-9fb0-87a08b45e06b",
            "itemType": "01",
            "recordTime": 1692617732000,
            "description": "TEST description-12345",
            "createTime": 1692652501808,
            "updateTime": 1692652659069
        }
    }
}
```


### 刪除登革熱防治紀錄
```url
POST /user-content/dengue/delete
```
* 權限: App使用者(GENERAL_PUBLIC)

#### Request-刪除登革熱防治紀錄
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 id | string | Y | 36 | | 紀錄id
 
```javascript
{
    "id": "b5c65827-0089-4cb1-8f1e-3b169524da06"
}
```

#### Error-刪除登革熱防治紀錄
 httpCode | 錯誤碼 | 說明
 --- | --- | ---
 400 | API_ERROR.ARGUMENT_ERROR | 輸入參數錯誤, 可參閱 errorDesc
 422 | SERVICE_ERROR.USER_CONTENT_DENGUE_INFO_NOT_EXIST | 使用者上傳登革熱記錄不存在
 403 | API_ERROR.PERMISSION_DENIED | 無此操作權限

#### Response-刪除登革熱防治紀錄
 欄位 | 型態 | 說明 
 ---  | --- | ---
 count | int | 成功刪除筆數

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "count": 1
        }
    }
}
```


### 刪除登革熱防治紀錄單一圖片
```url
POST /user-content/dengue/delete-image
```
* 權限: App使用者(GENERAL_PUBLIC)

#### Request-刪除登革熱防治紀錄單一圖片
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 id | string | Y | 36 | | 紀錄id
 objectKey | string | Y | 500 | 圖片objectKey
 
```javascript
{
    "id": "b5c65827-0089-4cb1-8f1e-3b169524da06",
    "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/5399c12-c5fd-4a2f-8d8a-641e1c63acea.png"
}
```

#### Error-刪除登革熱防治紀錄單一圖片
 httpCode | 錯誤碼 | 說明
 --- | --- | ---
 400 | API_ERROR.ARGUMENT_ERROR | 輸入參數錯誤, 可參閱 errorDesc
 422 | SERVICE_ERROR.USER_CONTENT_DENGUE_INFO_NOT_EXIST | 使用者上傳登革熱記錄不存在
 403 | API_ERROR.PERMISSION_DENIED | 無此操作權限

#### Response-刪除登革熱防治紀錄單一圖片
 欄位 | 型態 | 說明 
 ---  | --- | ---
 count | int | 成功刪除筆數

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "count": 1
        }
    }
}
```


## WEB端

### 取得管理列表
```url
POST /user-content-mgmt/dengue/list
```

* 權限: 租戶管理員(TENANT_ADMIN), 租戶使用者(TENANT_ROLE_USER) 

#### Request-取得管理列表
##### Request-取得管理列表-query (查詢條件json)
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 startDate | timestamp | Y |  | | 查詢起始日
 endDate | timestamp | Y |  | | 查詢截止日
 itemType | string | | 2 | | 上傳內容項目類別, 若未填表示查詢全部, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 keyword | string  | | 50 | | 查詢使用者姓名或手機關鍵字
 
##### Request-取得管理列表-pagination (分頁json)
 欄位 | 型態  | 必填 | 預設 | 說明
 ---|---|---|---|---
 current | int | | 1 | 當前頁數 
 pageSize | int | | 10 | 每頁結果數量，-1 為顯示所有
 
##### Request-取得管理列表-sorter (排序json) 
 欄位 | 型態  | 必填 | 預設 | 說明
 ---|---|---|---|--- 
 field | string | | recordTime | 排序欄位,可排序欄位有 recordTime, name, itemType, extraData, description
 order | string | | desc | 升序或降序 

```javascript
{
    "query": {
        "startDate": "2023-08-20",
        "endDate": "2023-08-21",
        "itemType": null,
        "keyword": null
    },
     "pagination": {
         "current": 1,
         "total": 1,
         "pageSize": 10
     },
     "sorter": {
         "field": "recordTime",
         "order": "desc"
     }
}
```

#### Response-取得管理列表
 欄位 | 型態 | 說明 
 ---  | --- | ---
 id | string | 紀錄id
 householdMemberId | string | householdMemberId
 name | string | 姓名
 mobile | string | 手機號碼
 itemType | string | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 targetTenantId | string | 上傳對象租戶id
 recordTime | timestamp | 上傳時間
 description | string | 說明
 address | string | 地址
 contentObjectList | json array | 上傳內容圖片 json array
 createTime | timestamp | 建立時間 
 updateTime | timestamp | 更新時間

##### Response-取得管理列表-contentObjectList(json)
 欄位 | 型態 | 說明 
 ---  | --- | ---
 objectKey | string | 圖檔objectKey
 url | string | 圖檔可download 的 url, 時效 3600 秒

```javascript
{
    "httpCode": 200,
    "result": {
        "data": [
            {
                "id": "fc00087b-843e-4511-84da-c233b37b5041",
                "householdMemberId": "150b53f5-7126-4900-9fb0-87a08b45e06b",
                "itemType": "01",
                "targetTenantId": "858b7fbb-3ba0-4d49-9882-c893a1ef07dc",
                "recordTime": 1692595800000,
                "description": "TEST description",
                "createTime": 1692606914905,
                "updateTime": 1692606914905,
                "contentObjectList": [
                    {
                        "objectKey": "user-content/dengue/A5555.jpg",
                        "url": "http://content-service/swift/v1/user-content/dengue/A5555.jpg"
                    },
                    {
                        "objectKey": "user-content/dengue/A9999.jpg",
                        "url": "http://content-service/swift/v1/user-content/dengue/A9999.jpg"
                    },
                    {
                        "objectKey": "user-content/dengue/A0001.jpg",
                        "url": "http://content-service/swift/v1/user-content/dengue/A0001.jpg"
                    }
                ],
                "name": "呂OO",
                "mobile": "0987654321",
                "address": "800台灣高雄市新興區中正三路4號"
            }
        ],
        "pagination": {
            "current": 1,
            "pageSize": 10,
            "total": 1
        },
        "sorter": {
            "field": "recordTime",
            "order": "desc"
        },
        "total": 1
    }
}
```


### 取得管理明細
```url
POST /user-content-mgmt/dengue/info
```

* 權限: 租戶管理員(TENANT_ADMIN), 租戶使用者(TENANT_ROLE_USER) 

#### Request-取得管理明細
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 id | string | Y | 36 | | 紀錄id

```javascript
{
    "id": "52577adb-e7f3-4b99-9ad3-89c8e301041c"
}
```

#### Response-取得管理明細
 欄位 | 型態 | 說明 
 ---  | --- | ---
 id | string | 紀錄id
 householdMemberId | string | householdMemberId
 name | string | 姓名
 mobile | string | 手機號碼
 itemType | string | 上傳內容項目類別, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 targetTenantId | string | 上傳對象租戶id
 recordTime | timestamp | 上傳時間
 description | string | 說明
 address | string | 地址
 contentObjectList | json array | 上傳內容圖片 json array
 createTime | timestamp | 建立時間 
 updateTime | timestamp | 更新時間

##### Response-取得管理明細-contentObjectList(json)
 欄位 | 型態 | 說明 
 ---  | --- | ---
 objectKey | string | 圖檔objectKey
 url | string | 圖檔可download 的 url, 時效 3600 秒 

```javascript
{
    "httpCode": 200,
    "result": {
        "data": {
            "id": "52577adb-e7f3-4b99-9ad3-89c8e301041c",
            "householdMemberId": "150b53f5-7126-4900-9fb0-87a08b45e06b",
            "itemType": "01",
            "recordTime": 1692617732000,
            "description": "TEST description",
            "createTime": 1692665824266,
            "updateTime": 1692665824266,
            "contentObjectList": [
                {
                    "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/4c3f15dd-8442-4834-9c47-ec274ffbda91.png",
                    "url": "http://content-service/swift/v1/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/4c3f15dd-8442-4834-9c47-ec274ffbda91.png"
                },
                {
                    "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/5399c12-c5fd-4a2f-8d8a-641e1c63acea.png",
                    "url": "http://content-service/swift/v1/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/5399c12-c5fd-4a2f-8d8a-641e1c63acea.png"
                },
                {
                    "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/A0001.jpg",
                    "url": "http://content-service/swift/v1/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/A0001.jpg"
                },
                {
                    "objectKey": "user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/bcee6b4e-856d-41aa-bff3-6aff115006d6.png",
                    "url": "http://content-service/swift/v1/user-content/dengue/150b53f5-7126-4900-9fb0-87a08b45e06b/bcee6b4e-856d-41aa-bff3-6aff115006d6.png"
                }
            ],
            "name": "呂OO",
            "mobile": "0973621449",
            "address": "800台灣高雄市新興區中正三路4號"
        }
    }
}
```

### 匯出管理列表
```url
POST /user-content-mgmt/dengue/export
```

#### Request-匯出管理列表
##### Request-匯出管理列表-query (查詢條件json)
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明  
 ---|---|---|---|---|---
 startDate | timestamp | Y |  | | 查詢起始日
 endDate | timestamp | Y |  | | 查詢截止日
 itemType | string | | 2 | | 上傳內容項目類別, 若未填表示查詢全部, 參閱 [上傳內容項目類別](#使用者上傳內容項目類別)
 keyword | string  | | 50 | | 查詢使用者姓名或手機關鍵字
 
```json
{
    "query": {
        "itemType": "01",
        "keyword": "keyword",
        "startDate":"2023-09-01",
        "endDate":"2023-10-06"
    }
}
```

#### Response-匯出管理列表

userContent_yyyyMMdd.xlsx