# 潛水日誌紀錄

**API 修改紀錄**
|版本|日期|備註|
| ------------ |------------ |------------ |
| v1 |2024/02/26| 發佈 |
| v1.1 |2024/06/26| 更新搜尋參數 |
| v1.2 |2024/06/28| 修改手錶及模式為複數 及 重要日誌 |

**潛水日誌紀錄**

潛水日誌列表

電腦錶資訊及潛水模式資訊 可以參考 [APP_INIT](https://hackmd.io/4wDuH85XSVu2uHbYymS9ng)

#### 網址
https://{domain}/api/v1/member-dive-log/index?pageSize=99&page=1

#### Http Method
GET

#### HTTP Header
accept-language : language code
apikey : apk key

#### Query Params
|欄位名稱|必填|說明|
| ------------ |:-----------: |------------ |
|pageSize|Y|每頁幾筆
|page|Y|頁數
|keyword|N|關鍵字
|sort_by|N|排序依據
|sort_rule|N|desc,asc
|is_star|N|重要日誌
|device_id[]|N|電腦錶id 複選
|dive_mode[]|N|篩選 複選
|start_date|N|日期區間 開始
|end_date|N|日期區間 結束
|start_time|N|時間區間 開始
|end_time|N|時間區間 結束

#### Query Params Example 排序
|名稱|網址
| ------------ | :-----------:
|時間 新→舊| sort_by=start_datetime&sort_rule=desc
|時間 舊→新| sort_by=start_datetime&sort_rule=asc
|最大深度 淺→深| sort_by=max_depth&sort_rule=asc
|最大深度 深→淺| sort_by=max_depth&sort_rule=desc
|潛水時間 長→短| sort_by=dive_time_sec&sort_rule=desc
|潛水時間 短→長| sort_by=dive_time_sec&sort_rule=asc
|最低水溫 小→大| sort_by=low_temp&sort_rule=asc
|最低水溫 大→小| sort_by=low_temp&sort_rule=desc
|潛水地點 Ａ→Ｚ| sort_by=dive_place&sort_rule=asc
|潛水地點 Ｚ→Ａ| sort_by=dive_place&sort_rule=desc

#### Query Params Example
|名稱|網址
| ------------ | :-----------:
|篩選 潛水模式| dive_mode[]=0&dive_mode[]=2
|篩選 重要日誌| is_star=1
|篩選 電腦錶| device_id[]=1&device_id[]=2
|日期區間| start_date=2024-05-05&end_date=2024-05-06
|時間區間| start_time=13:00&end_time=14:00

#### HTTP Request Body 傳入參數

|欄位名稱|必填|型態|欄位|備註|
| ------------ | :-----------: |:-----------: |------------ |------------ |

#### HTTP Response 回傳參數

|Name|Type|說明|
| ------------ | ------------ |------------ |
|id |int |日誌id |
|is_star |boolean | 重要日誌 |
|dive_date |string |淺水日期 |
|start_time |string |開始時間 |
|end_time |string |結束時間 |
|dive_mode |string |潛水模式 |
|max_depth |string |最大深度 |
|low_temp |string |最低水溫 |
|dive_time |string |潛水時間 |
|dive_place |string |潛水地點 |
|device_name |string |手錶型號 |
|serial_number |string |手錶序號 |
|dive_mode_id |int |潛水模式id |

#### Request Header Authoriztion

{
    "accept-language" : "en",     //or 'zh_tw'
    "apikey" : "api key string"
}

#### Json Example
Request Json

Response Json Success

{
    "status": true,
    "code": 200,
    "message": "cms/common.success",
    "result": {
        "pageCount": 1,
        "data": [
            {
                "id":1,
                "member_id": 1,
                "device_id": 1,
                "member_to_device_id": 6,
                "dive_date": "2024-01-30",
                "start_time": "21:18:31",
                "end_time": "21:26:03",
                "dive_mode": "freeDive",
                "max_depth": 34.25,
                "low_temp": 19,
                "dive_time": "00:07:41",
                "dive_place": null,
                "serial_mumber": "213123123",
                "device_name": "SHERWOOD-Logic",
                "dive_mode_id": 0
            },
            {
                "id":2,
                "member_id": 1,
                "device_id": 1,
                "member_to_device_id": 6,
                "dive_date": "2024-01-30",
                "start_time": "21:18:31",
                "end_time": "21:26:03",
                "dive_mode": "freeDive",
                "max_depth": 34.25,
                "low_temp": 19,
                "dive_time": "00:07:41",
                "dive_place": null,
                "serial_mumber": "213123123",
                "device_name": "SHERWOOD-Logic",
                "dive_mode_id": 0
            }
        ]
    }
}

Response Json Error