swagger-output.json

{
  "swagger": "2.0",
  "info": {
    "title": "SuperHandy 超人幫手",
    "description": "This is the final project for a Node.js course.",
    "version": "1.0.0"
  },
  "basePath": "/",
  "tags": [
    {
      "name": "Home",
      "description": "首頁"
    },
    {
      "name": "Find-tasks",
      "description": "找任務"
    },
    {
      "name": "Posts",
      "description": "刊登任務"
    },
    {
      "name": "Account",
      "description": "我的帳號"
    },
    {
      "name": "Sign-in",
      "description": "登入相關"
    },
    {
      "name": "Tasks",
      "description": "任務管理"
    },
    {
      "name": "Scheduler",
      "description": "排程"
    },
    {
      "name": "Notifications",
      "description": "系統通知"
    },
    {
      "name": "Chat",
      "description": "聊天室"
    },
    {
      "name": "Money",
      "description": "金流相關"
    },
    {
      "name": "General",
      "description": "通用"
    },
    {
      "name": "NotFound",
      "description": "頁面路由相關"
    }
  ],
  "schemes": [
    "http",
    "https"
  ],
  "securityDefinitions": {
    "Bearer": {
      "type": "apiKey",
      "in": "header",
      "name": "Authorization",
      "description": "JWT Token"
    }
  },
  "paths": {
    "/sign-up": {
      "post": {
        "tags": [
          "Sign-in"
        ],
        "summary": "註冊+寄信 (Register an Account and send a verification email)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "nickname is optional, while all the others are required.",
            "schema": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "example": "test@gmail.com"
                },
                "phone": {
                  "type": "string",
                  "example": "0912345678"
                },
                "firstName": {
                  "type": "string",
                  "example": "Ho"
                },
                "lastName": {
                  "type": "string",
                  "example": "Erik"
                },
                "nickname": {
                  "type": "string",
                  "example": "Erik"
                },
                "password": {
                  "type": "string",
                  "example": "12345678"
                },
                "confirmPassword": {
                  "type": "string",
                  "example": "12345678"
                }
              },
              "required": [
                "email",
                "phone",
                "firstName",
                "lastName",
                "password"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "註冊成功",
            "schema": {
              "$ref": "#/definitions/RegisterEmailSuccess"
            }
          },
          "400": {
            "description": "註冊失敗",
            "schema": {
              "$ref": "#/definitions/RegisterEmailError"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/verify-email": {
      "get": {
        "tags": [
          "Sign-in"
        ],
        "summary": "驗證註冊信 (Verify the registration email)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "驗證成功"
          },
          "400": {
            "description": "驗證失敗",
            "schema": {
              "$ref": "#/definitions/ValidateEmailError"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/resend-verification": {
      "post": {
        "tags": [
          "Sign-in"
        ],
        "summary": "重寄驗證信 (Resend an Email for verification)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "No matter what email is received, a reply will be sent indicating that the email has been sent.",
            "schema": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "example": "test@gmail.com"
                }
              },
              "required": [
                "email"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "信件已寄出"
          },
          "400": {
            "description": "信件已寄出"
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/sign-in": {
      "post": {
        "tags": [
          "Sign-in"
        ],
        "summary": "登入 (Sign-in)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "sign in an account",
            "schema": {
              "type": "object",
              "properties": {
                "account": {
                  "type": "string",
                  "example": "user1@example.com"
                },
                "password": {
                  "type": "string",
                  "example": "12345678"
                }
              },
              "required": [
                "account",
                "password"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "登入成功",
            "schema": {
              "$ref": "#/definitions/Sign"
            }
          },
          "400": {
            "description": "登入失敗",
            "schema": {
              "$ref": "#/definitions/Error400"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/forgot-password": {
      "post": {
        "tags": [
          "Sign-in"
        ],
        "summary": "忘記密碼+寄驗證信 (Forgot password and send an Email for verification)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "forgot password and send an Email for verification",
            "schema": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "example": "test@gmail.com"
                }
              },
              "required": [
                "email"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "信件已寄出"
          },
          "400": {
            "description": "信件已寄出"
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/forgot-reset-password": {
      "patch": {
        "tags": [
          "Sign-in"
        ],
        "summary": "忘記密碼並重設密碼 (Forget password and reset the password from email)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "",
            "schema": {
              "type": "object",
              "properties": {
                "password": {
                  "type": "string",
                  "example": "a1234567"
                },
                "confirmPassword": {
                  "type": "string",
                  "example": "a1234567"
                }
              },
              "required": [
                "password",
                "confirmPassword"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "重設成功"
          },
          "400": {
            "description": "重設失敗"
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/update-password": {
      "patch": {
        "tags": [
          "Sign-in"
        ],
        "summary": "更新密碼 (Update password after sign in)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "",
            "schema": {
              "type": "object",
              "properties": {
                "password": {
                  "type": "string",
                  "example": "12345678"
                },
                "confirmPassword": {
                  "type": "string",
                  "example": "12345678"
                },
                "oldPassword": {
                  "type": "string",
                  "example": "22345678"
                }
              },
              "required": [
                "password",
                "confirmPassword",
                "oldPassword"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "重設成功"
          },
          "400": {
            "description": "重設失敗"
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/profile": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "取得使用者資料概要 (Summary of User Data)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/getProfileSuccess"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/info-form": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "取得使用者表單資料 (Get User Form Data)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/getInfoFormSuccess"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      },
      "patch": {
        "tags": [
          "Account"
        ],
        "summary": "更新使用者表單資料 (Update User Form Data)",
        "description": "",
        "parameters": [
          {
            "name": "parameter",
            "in": "body",
            "description": "可更新部分欄位",
            "schema": {
              "type": "object",
              "properties": {
                "nickname": {
                  "type": "string",
                  "example": "Erik"
                },
                "firstName": {
                  "type": "string",
                  "example": "Erik"
                },
                "lastName": {
                  "type": "string",
                  "example": "Chen"
                },
                "email": {
                  "type": "string",
                  "example": "erik@gmail.com"
                },
                "phone": {
                  "type": "string",
                  "example": "0912345678"
                },
                "location": {
                  "type": "object",
                  "properties": {
                    "city": {
                      "type": "string",
                      "example": "臺北市"
                    },
                    "dist": {
                      "type": "string",
                      "example": "中正區"
                    },
                    "address": {
                      "type": "string",
                      "example": "忠孝東路一段1號"
                    }
                  }
                },
                "posterIntro": {
                  "type": "string",
                  "example": "我是海報人"
                },
                "helperIntro": {
                  "type": "string",
                  "example": "我是幫手人"
                },
                "helperSkills": {
                  "type": "array",
                  "example": [
                    "人力派遣",
                    "市場調查"
                  ],
                  "items": {
                    "type": "string"
                  }
                },
                "updatedAt": {
                  "type": "string",
                  "example": "2021-05-20T08:00:00.000Z"
                },
                "avatarPath": {
                  "type": "string",
                  "example": "https://i.imgur.com/3Z4nZCY.jpg"
                }
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/updateInfoForm"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "查不到啦"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/points": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "取得目前超人幣、幫手幣的餘額 (Get the current balance of Super Coins and Helper Coins)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getPoints"
            }
          },
          "400": {
            "description": "Token 失敗",
            "schema": {
              "$ref": "#/definitions/ErrorToken"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/profile-stats": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "取得6組數字統計 (Get user statistics figures)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getProfileStats"
            }
          },
          "400": {
            "description": "Token 失敗",
            "schema": {
              "$ref": "#/definitions/ErrorToken"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/points/history": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "點數歷史紀錄 (Get the history of points)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getPointsHistory"
            }
          },
          "400": {
            "description": "Token 失敗",
            "schema": {
              "$ref": "#/definitions/ErrorToken"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/points/purchase": {
      "post": {
        "tags": [
          "Account"
        ],
        "summary": "購買點數 (Purchase the super coin)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "schema": {
              "type": "object",
              "properties": {
                "money": {
                  "type": "number",
                  "example": 500
                }
              },
              "required": [
                "money"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "購買成功",
            "schema": {
              "$ref": "#/definitions/cashbackPoints"
            }
          },
          "400": {
            "description": "Token 失敗",
            "schema": {
              "$ref": "#/definitions/ErrorToken"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/points/cashback": {
      "post": {
        "tags": [
          "Account"
        ],
        "summary": "返還現金 (Refund in cash)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "schema": {
              "type": "object",
              "properties": {
                "point": {
                  "type": "number",
                  "example": 300
                },
                "bank": {
                  "type": "string",
                  "example": "台新銀行"
                },
                "bankNo": {
                  "type": "string",
                  "example": "812"
                },
                "bankAcct": {
                  "type": "string",
                  "example": "19011485059700"
                }
              },
              "required": [
                "point",
                "bank",
                "bankNo",
                "bankAcct"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "返還成功",
            "schema": {
              "$ref": "#/definitions/cashbackPoints"
            }
          },
          "400": {
            "description": "Token 失敗",
            "schema": {
              "$ref": "#/definitions/ErrorToken"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/comments": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "查看評論的歷史紀錄 (Get review history)",
        "description": "",
        "parameters": [
          {
            "name": "role",
            "in": "query",
            "description": "角色",
            "type": "string",
            "enum": [
              "幫手",
              "案主"
            ],
            "default": "案主"
          },
          {
            "name": "categories",
            "in": "query",
            "description": "服務類別，可複選(使用,區隔) (沒有給參數代表全部)",
            "default": "寵物陪伴",
            "type": "string"
          },
          {
            "name": "reviewStatus",
            "in": "query",
            "description": "角色的評價狀態 (沒有給參數代表全部)",
            "type": "string",
            "enum": [
              "待評價",
              "已評價"
            ],
            "default": "已評價"
          },
          {
            "name": "yourStar",
            "in": "query",
            "description": "你的星星數(1,2,3,4,5, 沒有給參數代表全部，沒評價也算在全部)",
            "type": "integer",
            "enum": [
              1,
              2,
              3,
              4,
              5
            ],
            "default": 4
          },
          {
            "name": "limit",
            "in": "query",
            "description": "每一頁的資料筆數(預設為10)，最多100",
            "type": "integer",
            "default": 10
          },
          {
            "name": "page",
            "in": "query",
            "description": "第幾頁(預設為1)",
            "type": "integer",
            "default": 1
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getCommentsHist"
            }
          },
          "400": {
            "description": "欄位錯誤提示",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40102]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/account/comments/starCounts": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "在評價頁面查看星星記數 (View star counts on the review page)",
        "description": "",
        "parameters": [
          {
            "name": "role",
            "in": "query",
            "description": "角色",
            "type": "string",
            "enum": [
              "幫手",
              "案主"
            ],
            "default": "案主"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getStarCounts"
            }
          },
          "400": {
            "description": "缺少角色參數",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40102]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/home/completed-cases": {
      "get": {
        "tags": [
          "Home"
        ],
        "summary": "取得已完成之案例 (Get Completed Cases)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getCompletedCasesSuccess"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/home/completed-reviews": {
      "get": {
        "tags": [
          "Home"
        ],
        "summary": "取得真實心得評價 (Get Completed Reviews)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getSuperhandyReviewSuccess"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/home/task-stats": {
      "get": {
        "tags": [
          "Home"
        ],
        "summary": "取得任務統計數量 (Get task statistics count)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getTaskStatsSuccess"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/home/excellent-helpers": {
      "get": {
        "tags": [
          "Home"
        ],
        "summary": "取得優秀幫手資料 (Get excellent helpers)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getExcellentHelpersSuccess"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/general/categories": {
      "get": {
        "tags": [
          "General"
        ],
        "summary": "取得服務類別，包含任務說明的template (Get Service Category (including task description template)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getCategorySuccess"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/general/exposure-plan": {
      "get": {
        "tags": [
          "General"
        ],
        "summary": "取得曝光方案 (Get exposure plan)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getPlanSuccess"
            }
          },
          "404": {
            "description": "無此路由",
            "schema": {
              "$ref": "#/definitions/Error404"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/general/upload-image": {
      "post": {
        "tags": [
          "General"
        ],
        "summary": "上傳圖片 (Upload image)",
        "description": "",
        "parameters": [
          {
            "name": "file",
            "in": "formData",
            "required": true,
            "type": "file",
            "description": "圖片檔案"
          }
        ],
        "responses": {
          "200": {
            "description": "上傳成功",
            "schema": {
              "$ref": "#/definitions/uploadImage"
            }
          },
          "400": {
            "description": "無檔案或格式不正確、上傳圖片失敗",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40106,40401]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "無檔案或格式不正確、上傳圖片失敗",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "File too large"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "MulterError"
                    },
                    "message": {
                      "type": "string",
                      "example": "File too large"
                    },
                    "code": {
                      "type": "string",
                      "example": "LIMIT_FILE_SIZE"
                    },
                    "field": {
                      "type": "string",
                      "example": "file"
                    },
                    "storageErrors": {
                      "type": "array",
                      "example": [],
                      "items": {}
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 500
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/find-task/detail/{taskId}": {
      "get": {
        "tags": [
          "Find-tasks"
        ],
        "summary": "取得任務詳情 (Get task details)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/findTaskDetails"
            }
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/find-task/list/query": {
      "get": {
        "tags": [
          "Find-tasks"
        ],
        "summary": "取得未媒合之任務列表(列表模式)",
        "description": "",
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "description": "篩選縣市",
            "default": "臺北市",
            "type": "string"
          },
          {
            "name": "dist",
            "in": "query",
            "description": "篩選地區",
            "default": "信義區",
            "type": "string"
          },
          {
            "name": "isUrgent",
            "in": "query",
            "description": "是否為急件",
            "default": "true",
            "type": "string"
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "排序依據(newest,highestSalary,mostEnquiries)(最新刊登 最高薪資 最高詢問度)",
            "default": "newest",
            "type": "string"
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "關鍵字查詢(任務標題、任務說明)",
            "default": "",
            "type": "string"
          },
          {
            "name": "services",
            "in": "query",
            "description": "服務類別，可複選(使用,區隔)",
            "default": "",
            "type": "string"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "每一頁的資料筆數(default:10)",
            "default": "6",
            "type": "string"
          },
          {
            "name": "page",
            "in": "query",
            "description": "第幾頁(default:1)",
            "default": "1",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/findTaskListGeneral"
            }
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/find-task/map/query": {
      "get": {
        "tags": [
          "Find-tasks"
        ],
        "summary": "取得未媒合之任務列表(地圖模式)",
        "description": "有填寫縣市地區時，僅顯示該區任務(不使用半徑); 使用經緯度時，顯示該半徑內任務。",
        "parameters": [
          {
            "name": "longitude",
            "in": "query",
            "description": "經度(中心點)",
            "default": "121.5654268",
            "type": "string"
          },
          {
            "name": "latitude",
            "in": "query",
            "description": "緯度(中心點)",
            "default": "25.0329636",
            "type": "string"
          },
          {
            "name": "city",
            "in": "query",
            "description": "縣市(中心點)",
            "default": "臺北市",
            "type": "string"
          },
          {
            "name": "dist",
            "in": "query",
            "description": "地區(中心點)",
            "default": "信義區",
            "type": "string"
          },
          {
            "name": "radius",
            "in": "query",
            "description": "半徑0~10公里(不包含0，預設3公里)",
            "default": "3",
            "type": "string"
          },
          {
            "name": "isUrgent",
            "in": "query",
            "description": "是否為急件",
            "default": "true",
            "type": "string"
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "關鍵字查詢(任務標題、任務說明)",
            "default": "",
            "type": "string"
          },
          {
            "name": "services",
            "in": "query",
            "description": "服務類別，可複選(使用,區隔)",
            "default": "",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/findTaskListMap"
            }
          },
          "400": {
            "description": "請輸入經緯度或縣市區域、找不到該地址、查無資料、無檔案或格式不正確(半徑必須大於0)",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40105, 40400, 40210, 40106]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/find-task/highlight": {
      "get": {
        "tags": [
          "Find-tasks"
        ],
        "summary": "取得未媒合之任務列表(限時推薦)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/findTaskListHighlight"
            }
          },
          "400": {
            "description": "查無資料",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40210]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/find-task/apply/{taskId}": {
      "post": {
        "tags": [
          "Find-tasks"
        ],
        "summary": "我要接案",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "等待媒合中"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、查無此任務、無法應徵自己的任務、已應徵過此任務",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104,40212,40216,40217]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/check-location": {
      "get": {
        "tags": [
          "Posts"
        ],
        "summary": "檢查地址 (Check Location)",
        "description": "",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "description": "完整地址",
            "default": "臺北市信義區市府路45號",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "formatted_address": {
                      "type": "string",
                      "example": "No. 45, City Hall Rd, Xinyi District, Taipei City, Taiwan 110"
                    },
                    "location": {
                      "type": "object",
                      "properties": {
                        "lat": {
                          "type": "number",
                          "example": 25.0341222
                        },
                        "lng": {
                          "type": "number",
                          "example": 121.5640212
                        }
                      }
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "找不到該地址",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "找不到該地址"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "40400"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/draft": {
      "post": {
        "tags": [
          "Posts"
        ],
        "summary": "儲存草稿 (Save draft)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "任務資料",
            "schema": {
              "$ref": "#/definitions/draftTaskDetail"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "儲存草稿成功"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "taskId": {
                      "type": "string",
                      "example": "645be336a6b4506a5506be10"
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "欄位錯誤提示",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "40102"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "系統錯誤，請稍後再試"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/draft/{taskId}": {
      "post": {
        "tags": [
          "Posts"
        ],
        "summary": "發佈草稿 (Publish draft)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "任務資料",
            "schema": {
              "$ref": "#/definitions/publishTaskDetail"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "發佈草稿成功",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "發佈草稿成功"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、欄位錯誤提示、查無此任務、沒有權限、任務狀態錯誤、超人幣不足、幫手幣不足、找不到該地址",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40102, 40212, 40302, 40214, 40211, 40211, 40400]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "系統錯誤，請稍後再試"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      },
      "get": {
        "tags": [
          "Posts"
        ],
        "summary": "取得草稿 (Get the draft)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/getDraftResponse"
            }
          },
          "400": {
            "description": "Id 格式錯誤、查無此任務、沒有權限、任務狀態錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40212, 40302, 40214]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "系統錯誤，請稍後再試"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      },
      "put": {
        "tags": [
          "Posts"
        ],
        "summary": "更新草稿 (Update the draft)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "任務資料",
            "schema": {
              "$ref": "#/definitions/draftTaskDetail"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "更新草稿成功"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、欄位錯誤提示、查無此任務、沒有權限、任務狀態錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40102, 40212, 40302, 40214]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "系統錯誤，請稍後再試"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Posts"
        ],
        "summary": "刪除草稿(Delete the draft)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "刪除草稿成功"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、查無此任務、沒有權限、任務狀態錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40212, 40302, 40214]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "系統錯誤，請稍後再試"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/publish": {
      "post": {
        "tags": [
          "Posts"
        ],
        "summary": "發佈任務 (Publish a task)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "description": "任務資料",
            "schema": {
              "$ref": "#/definitions/publishTaskDetail"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "發佈任務成功",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "發佈任務成功"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "taskId": {
                      "type": "string",
                      "example": "645be336a6b4506a5506be10"
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "欄位錯誤提示、超人幣不足、幫手幣不足、找不到該地址",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40102, 40211, 40211, 40400]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "Server Error",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "伺服器錯誤"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/edit/{taskId}": {
      "post": {
        "tags": [
          "Posts"
        ],
        "summary": "編輯下架任務 (Edit the unpublished task)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "任務資料",
            "schema": {
              "$ref": "#/definitions/unpublishEditDetail"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "編輯下架任務成功",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "編輯下架任務成功"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、欄位錯誤提示、沒有權限、任務狀態錯誤、找不到該地址",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40102, 40302, 40214, 40400]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "Server Error",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "伺服器錯誤"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/republish/{taskId}": {
      "post": {
        "tags": [
          "Posts"
        ],
        "summary": "重新發佈任務 (Republish the task)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "重新發佈任務成功",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "重新發佈任務成功"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、查無此任務、沒有權限、任務狀態錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40212, 40302, 40214]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "Server Error",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "伺服器錯誤"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/post-task/unpublish/{taskId}": {
      "post": {
        "tags": [
          "Posts"
        ],
        "summary": "下架任務 (Unpublish the task)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "下架任務成功",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "success"
                },
                "message": {
                  "type": "string",
                  "example": "下架任務成功"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "400": {
            "description": "Id 格式錯誤、查無此任務、沒有權限、任務狀態錯誤",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40212, 40302, 40214]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "Server Error",
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "example": "伺服器錯誤"
                }
              },
              "xml": {
                "name": "main"
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/notifications/list": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "取得通知清單 (Get all notifications)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得通知成功",
            "schema": {
              "$ref": "#/definitions/getNotifyList"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/notifications/read/{notifyId}": {
      "patch": {
        "tags": [
          "Notifications"
        ],
        "summary": "將某個通知標記為已讀 (Mark a notification as read)",
        "description": "",
        "parameters": [
          {
            "name": "notifyId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "已讀通知成功"
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/notifications/all-read": {
      "patch": {
        "tags": [
          "Notifications"
        ],
        "summary": "全部已讀 (Mark ａll notifications as read)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "已讀通知成功"
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/linepay/payment": {
      "post": {
        "tags": [
          "Money"
        ],
        "summary": "建立 LinePay 訂單 (Create alinePay payment)",
        "description": "",
        "parameters": [
          {
            "name": "parameter_name",
            "in": "body",
            "schema": {
              "type": "object",
              "properties": {
                "money": {
                  "type": "number",
                  "example": 500
                }
              },
              "required": [
                "money"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "建立 linepay 訂單成功",
            "schema": {
              "$ref": "#/definitions/paymentRequest"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/linepay/confirm": {
      "get": {
        "tags": [
          "Money"
        ],
        "summary": "LinePay 確認支付",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "linepay 交易成功"
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/auth/google": {
      "get": {
        "tags": [
          "Sign-in"
        ],
        "summary": "第三方登入 - google 轉向同意頁",
        "description": "",
        "parameters": [],
        "responses": {
          "302": {
            "description": "第三方登入 - google 轉向同意頁"
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/auth/google/callback": {
      "get": {
        "tags": [
          "Sign-in"
        ],
        "summary": "第三方登入 - 取得 google 資訊",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "第三方登入 - 取得 google 資訊",
            "schema": {
              "$ref": "#/definitions/googleCallback"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/auth/google/sign-in/{userId}": {
      "post": {
        "tags": [
          "Sign-in"
        ],
        "summary": "第三方登入 - 註冊",
        "description": "",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "請將 /google/callback 回傳資訊提供到這支 api",
            "schema": {
              "type": "object",
              "properties": {
                "phone": {
                  "type": "string",
                  "example": "0912345678"
                },
                "firstName": {
                  "type": "string",
                  "example": "小明"
                },
                "lastName": {
                  "type": "string",
                  "example": "王"
                }
              },
              "required": [
                "phone",
                "firstName",
                "lastName"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "第三方登入 google - 註冊",
            "schema": {
              "$ref": "#/definitions/googleSignUp"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/tasks/management/poster/query": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "列出發案歷史紀錄(篩選模式)",
        "description": "",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "篩選狀態",
            "default": "全部",
            "enum": [
              "全部",
              "草稿",
              "媒合中",
              "進行中",
              "已完成",
              "已下架",
              "未成立"
            ],
            "type": "string"
          },
          {
            "name": "city",
            "in": "query",
            "description": "篩選縣市",
            "default": "臺北市",
            "type": "string"
          },
          {
            "name": "dist",
            "in": "query",
            "description": "篩選地區",
            "default": "信義區",
            "type": "string"
          },
          {
            "name": "isUrgent",
            "in": "query",
            "description": "是否為急件",
            "default": "true",
            "type": "string"
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "排序依據(newest,highestSalary,mostEnquiries)(最新刊登 最高薪資 最高詢問度)",
            "default": "newest",
            "type": "string"
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "關鍵字查詢(任務標題、任務說明)",
            "default": "",
            "type": "string"
          },
          {
            "name": "services",
            "in": "query",
            "description": "服務類別，可複選(使用,區隔)",
            "default": "",
            "type": "string"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "每一頁的資料筆數(default:10)",
            "default": "10",
            "type": "string"
          },
          {
            "name": "page",
            "in": "query",
            "description": "第幾頁(default:1)",
            "default": "1",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getTaskQuery"
            }
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/helper/query": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "列出接案歷史紀錄(篩選模式)",
        "description": "",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "篩選狀態",
            "default": "全部",
            "enum": [
              "全部",
              "媒合中",
              "進行中",
              "已完成",
              "已下架",
              "未成立"
            ],
            "type": "string"
          },
          {
            "name": "city",
            "in": "query",
            "description": "篩選縣市",
            "default": "臺北市",
            "type": "string"
          },
          {
            "name": "dist",
            "in": "query",
            "description": "篩選地區",
            "default": "信義區",
            "type": "string"
          },
          {
            "name": "isUrgent",
            "in": "query",
            "description": "是否為急件",
            "default": "true",
            "type": "string"
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "排序依據(newest,highestSalary,mostEnquiries)(最新刊登 最高薪資 最高詢問度)",
            "default": "newest",
            "type": "string"
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "關鍵字查詢(任務標題、任務說明)",
            "default": "",
            "type": "string"
          },
          {
            "name": "services",
            "in": "query",
            "description": "服務類別，可複選(使用,區隔)",
            "default": "",
            "type": "string"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "每一頁的資料筆數(default:10)",
            "default": "10",
            "type": "string"
          },
          {
            "name": "page",
            "in": "query",
            "description": "第幾頁(default:1)",
            "default": "1",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getTaskQuery"
            }
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/poster": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "列出發案歷史紀錄 (Get all posted tasks history records)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getPostedTasksHist"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/helper": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "列出接案歷史紀錄 (Get all applied tasks history records)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getAppliedTasksHist"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/{taskId}": {
      "get": {
        "tags": [
          "Tasks"
        ],
        "summary": "取得任務詳情 (Get task details)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得成功",
            "schema": {
              "$ref": "#/definitions/getTaskDetails"
            }
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Tasks"
        ],
        "summary": "刪除任務 (Delete task)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "刪除成功"
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/confirm-acceptance/{taskId}": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "案主確認驗收 (Confirm acceptance)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "確認成功"
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/refuse-acceptance/{taskId}": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "案主退回驗收 (Refuse acceptance)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "上傳內容",
            "schema": {
              "$ref": "#/definitions/refuseAcceptanceReq"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "退回成功"
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限、該幫手未申請或不存在",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302, 40215]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/upload-acceptance/{taskId}": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "幫手上傳驗收內容 (Upload acceptance)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "上傳內容",
            "schema": {
              "$ref": "#/definitions/uploadAcceptanceReq"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "上傳成功"
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/comment/{taskId}": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "評分與留言 (Rating and Review)",
        "description": "會看 userId 決定是幫手還是案主，前端無需帶此參數",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "parameter_name",
            "in": "body",
            "description": "評價資料",
            "schema": {
              "$ref": "#/definitions/ratingAndReviewReq"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "確認成功"
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/management/confirm-helper/{taskId}/{helperId}": {
      "post": {
        "tags": [
          "Tasks"
        ],
        "summary": "案主確認幫手人選 (Confirm selected helper)",
        "description": "",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "type": "string"
          },
          {
            "name": "helperId",
            "in": "path",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "確認成功"
          },
          "400": {
            "description": "Id 格式錯誤、任務狀態錯誤、查無此任務、沒有權限、該幫手未申請或不存在",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40214, 40212, 40302, 40215]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/tasks/scheduler/check-expired-tasks": {
      "post": {
        "tags": [
          "Scheduler"
        ],
        "summary": "過期任務檢查 (Check Expired Tasks)",
        "description": "",
        "parameters": [],
        "responses": {
          "200": {
            "description": "確認成功"
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        }
      }
    },
    "/chat/list": {
      "get": {
        "tags": [
          "Chat"
        ],
        "summary": "取得聊天室列表 (Get all chatRoom list)",
        "description": "使用taskId作為聊天室的id。time表示最後一則訊息的時間。(無訊息時為null)",
        "parameters": [],
        "responses": {
          "200": {
            "description": "取得聊天室列表成功",
            "schema": {
              "$ref": "#/definitions/getChatRoomList"
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    },
    "/chat/history": {
      "get": {
        "tags": [
          "Chat"
        ],
        "summary": "取得聊天室歷史訊息 (Get chat history by taskId)",
        "description": "查詢該聊天室的全部訊息",
        "parameters": [
          {
            "name": "taskId",
            "in": "query",
            "description": "使用taskId作為聊天d",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "取得聊天室歷史訊息成功",
            "schema": {
              "$ref": "#/definitions/getChatHistory"
            }
          },
          "400": {
            "description": "Id 格式錯誤、查無此任務、沒有權限",
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "false"
                },
                "message": {
                  "type": "string",
                  "example": "錯誤訊息"
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "[40104, 40212, 40302]"
                    },
                    "statusCode": {
                      "type": "number",
                      "example": 400
                    },
                    "isOperational": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              },
              "xml": {
                "name": "main"
              }
            }
          },
          "500": {
            "description": "系統錯誤",
            "schema": {
              "$ref": "#/definitions/Error500"
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    }
  },
  "definitions": {
    "Success": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "example": "成功訊息"
        }
      }
    },
    "Error400": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "example": "錯誤訊息"
        }
      }
    },
    "ErrorToken": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "false"
        },
        "message": {
          "type": "string",
          "example": "你尚未登入"
        },
        "error": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "example": "40300"
            }
          }
        }
      }
    },
    "Error404": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "example": "外太空也找不到這個頁面"
        }
      }
    },
    "Error500": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "example": "系統錯誤，請稍後再試"
        }
      }
    },
    "Sign": {
      "type": "object",
      "properties": {
        "token": {
          "type": "string",
          "example": "abcde"
        },
        "_id": {
          "type": "string",
          "example": "123456789"
        }
      }
    },
    "RegisterEmailSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "message": {
          "type": "string",
          "example": "請至 Email 查收信件"
        }
      }
    },
    "RegisterEmailError": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "example": "請稍後重試或聯絡管理員"
        }
      }
    },
    "ValidateEmailError": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "example": "信箱驗證失敗"
        }
      }
    },
    "getCategorySuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "example": "到府驅蟲"
              },
              "template": {
                "type": "string",
                "example": "請填寫以下資訊：\n1. 蟲種：\n2. 家居面積：\n3. 服務時間："
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getPlanSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "example": "一般曝光"
              },
              "price": {
                "type": "string",
                "example": "20"
              },
              "items": {
                "type": "array",
                "example": [
                  "無理由修改",
                  "極速退點",
                  "刊登時間30天"
                ],
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getCompletedCasesSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "example": "已完成"
              },
              "title": {
                "type": "string",
                "example": "陪我家狗玩"
              },
              "salary": {
                "type": "number",
                "example": 300
              },
              "createAt": {
                "type": "string",
                "example": "2023-01-30T04:34:56.000Z"
              },
              "completedAt": {
                "type": "string",
                "example": "2022-02-23T00:19:50.000Z"
              },
              "location": {
                "type": "object",
                "properties": {
                  "longitude": {
                    "type": "number",
                    "example": 121.53868
                  },
                  "latitude": {
                    "type": "number",
                    "example": 25.02697
                  },
                  "address": {
                    "type": "string",
                    "example": "臺北市松山區復興北路15號"
                  }
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getSuperhandyReviewSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "_id": {
                "type": "string",
                "example": "644fdf6b56c25a7e04b77197"
              },
              "comment": {
                "type": "string",
                "example": "個人物品多 之前透過此平台搜尋到 此清潔整理員工作時都會注意細節 每次需要時依舊還是會想要主動聯繫此清潔整理員"
              },
              "name": {
                "type": "string",
                "example": "翁"
              },
              "avatar": {
                "type": "string",
                "example": ""
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getTaskStatsSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "totalPublished": {
              "type": "number",
              "example": 3
            },
            "totalCompleted": {
              "type": "number",
              "example": 2
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getExcellentHelpersSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "lastName": {
                "type": "string",
                "example": "王"
              },
              "avatar": {
                "type": "string",
                "example": "https://i.imgur.com/1234567.jpg"
              },
              "completedTasks": {
                "type": "number",
                "example": 130
              },
              "completionRate": {
                "type": "number",
                "example": 90
              },
              "rating": {
                "type": "object",
                "properties": {
                  "overall": {
                    "type": "number",
                    "example": 4.8
                  },
                  "categories": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "排隊代購"
                        },
                        "star": {
                          "type": "number",
                          "example": 4.5
                        },
                        "totalReviews": {
                          "type": "number",
                          "example": 30
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getPoints": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "superCoin": {
              "type": "number",
              "example": 0
            },
            "helperCoin": {
              "type": "number",
              "example": 0
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getProfileStats": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "superCoin": {
              "type": "number",
              "example": 0
            },
            "helperCoin": {
              "type": "number",
              "example": 0
            },
            "numOfPostTasks": {
              "type": "number",
              "example": 1
            },
            "numOfCompletedTasks": {
              "type": "number",
              "example": 3
            },
            "ratingPoster": {
              "type": "number",
              "example": 5
            },
            "ratingHelper": {
              "type": "number",
              "example": 4.67
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getProfileSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "_id": {
              "type": "string",
              "example": "645905b344f899648941de61"
            },
            "email": {
              "type": "string",
              "example": "user1@example.com"
            },
            "firstName": {
              "type": "string",
              "example": "文方"
            },
            "lastName": {
              "type": "string",
              "example": "翁"
            },
            "avatarPath": {
              "type": "string",
              "example": ""
            },
            "nickname": {
              "type": "string",
              "example": "小文"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "查詢成功"
        }
      }
    },
    "getInfoFormSuccess": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "example": "user1@example.com"
            },
            "firstName": {
              "type": "string",
              "example": "文方"
            },
            "lastName": {
              "type": "string",
              "example": "翁"
            },
            "phone": {
              "type": "string",
              "example": "0932345678"
            },
            "avatarPath": {
              "type": "string",
              "example": ""
            },
            "location": {
              "type": "object",
              "properties": {
                "city": {
                  "type": "string",
                  "example": "臺北市"
                },
                "dist": {
                  "type": "string",
                  "example": "中正區"
                },
                "address": {
                  "type": "string",
                  "example": "中正區重慶南路一段122號"
                }
              }
            },
            "posterIntro": {
              "type": "string",
              "example": "我是公正黨文宣部副主任兼黨部發言人。"
            },
            "helperIntro": {
              "type": "string",
              "example": ""
            },
            "helperSkills": {
              "type": "array",
              "example": [],
              "items": {}
            }
          }
        },
        "message": {
          "type": "string",
          "example": "查詢成功"
        }
      }
    },
    "updateInfoForm": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "example": "user1@example.com"
            },
            "firstName": {
              "type": "string",
              "example": "Erik"
            },
            "lastName": {
              "type": "string",
              "example": "Chen"
            },
            "nickname": {
              "type": "string",
              "example": "小文"
            },
            "phone": {
              "type": "string",
              "example": "0932345678"
            },
            "address": {
              "type": "string",
              "example": "臺北市"
            },
            "posterIntro": {
              "type": "string",
              "example": "我是海報人"
            },
            "helperIntro": {
              "type": "string",
              "example": "我是幫手人"
            },
            "helperSkills": {
              "type": "array",
              "example": [
                "人力派遣",
                "市場調查"
              ],
              "items": {
                "type": "string"
              }
            },
            "updatedAt": {
              "type": "string",
              "example": "2023-05-08T14:37:43.829Z"
            }
          }
        }
      }
    },
    "draftTaskDetail": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "example": "任務標題"
        },
        "category": {
          "type": "string",
          "example": "到府驅蟲"
        },
        "description": {
          "type": "string",
          "example": ""
        },
        "salary": {
          "type": "number",
          "example": 1000
        },
        "exposurePlan": {
          "type": "string",
          "example": "一般曝光"
        },
        "imgUrls": {
          "type": "array",
          "example": [
            "https://example.com/image1.jpg",
            "https://example.com/mage2.jpg"
          ],
          "items": {
            "type": "string"
          }
        },
        "contactInfo": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "example": "王小明"
            },
            "phone": {
              "type": "string",
              "example": "0912345678"
            },
            "email": {
              "type": "string",
              "example": "ming@gmail.com"
            }
          }
        },
        "location": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "example": "臺北市"
            },
            "dist": {
              "type": "string",
              "example": "信義區"
            },
            "address": {
              "type": "string",
              "example": "臺北市信義區市府路45號"
            }
          }
        }
      }
    },
    "publishTaskDetail": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "example": "任務標題"
        },
        "category": {
          "type": "string",
          "example": "到府驅蟲"
        },
        "description": {
          "type": "string",
          "example": "任務描述"
        },
        "taskTrans": {
          "type": "object",
          "properties": {
            "superCoin": {
              "type": "number",
              "example": 1000
            },
            "helperCoin": {
              "type": "number",
              "example": 0
            }
          }
        },
        "salary": {
          "type": "number",
          "example": 1000
        },
        "exposurePlan": {
          "type": "string",
          "example": "一般曝光"
        },
        "imgUrls": {
          "type": "array",
          "example": [
            "https://example.com/image1.jpg",
            "https://example.com/mage2.jpg"
          ],
          "items": {
            "type": "string"
          }
        },
        "contactInfo": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "example": "王小明"
            },
            "phone": {
              "type": "string",
              "example": "0912345678"
            },
            "email": {
              "type": "string",
              "example": "ming@gmail.com"
            }
          }
        },
        "location": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "example": "臺北市"
            },
            "dist": {
              "type": "string",
              "example": "信義區"
            },
            "address": {
              "type": "string",
              "example": "臺北市信義區市府路45號"
            }
          }
        }
      }
    },
    "getDraftResponse": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "userId": {
              "type": "string",
              "example": "645f125ab001884876e3a12a"
            },
            "status": {
              "type": "string",
              "example": "draft"
            },
            "title": {
              "type": "string",
              "example": "任務標題"
            },
            "category": {
              "type": "string",
              "example": "到府驅蟲"
            },
            "description": {},
            "salary": {
              "type": "number",
              "example": 1000
            },
            "exposurePlan": {
              "type": "string",
              "example": "一般曝光"
            },
            "imgUrls": {
              "type": "array",
              "example": [],
              "items": {}
            },
            "contactInfo": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "example": "王小明"
                },
                "phone": {
                  "type": "string",
                  "example": "0912345678"
                },
                "email": {
                  "type": "string",
                  "example": "ming@gmail.com"
                }
              }
            },
            "location": {
              "type": "object",
              "properties": {
                "city": {
                  "type": "string",
                  "example": "臺北市"
                },
                "dist": {
                  "type": "string",
                  "example": "信義區"
                },
                "address": {
                  "type": "string",
                  "example": "臺北市信義區市府路45號"
                }
              }
            },
            "viewers": {
              "type": "array",
              "example": [],
              "items": {}
            },
            "viewerCount": {
              "type": "number",
              "example": 0
            },
            "isUrgent": {
              "type": "boolean",
              "example": false
            },
            "time": {
              "type": "object",
              "properties": {
                "createdAt": {
                  "type": "string",
                  "example": "2023-05-16T05:21:26.144Z"
                },
                "updatedAt": {
                  "type": "string",
                  "example": "2023-05-16T05:21:26.144Z"
                }
              }
            },
            "reviews": {
              "type": "array",
              "example": [],
              "items": {}
            },
            "submittedInfo": {
              "type": "object",
              "properties": {
                "imgUrls": {
                  "type": "array",
                  "example": [],
                  "items": {}
                }
              }
            },
            "helpers": {
              "type": "array",
              "example": [],
              "items": {}
            },
            "taskId": {
              "type": "string",
              "example": "6460a24905b52c47e04f4f38"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得草稿成功"
        }
      }
    },
    "unpublishEditDetail": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string",
          "example": "到府驅蟲"
        },
        "description": {
          "type": "string",
          "example": "這個任務非常困難"
        },
        "imgUrls": {
          "type": "array",
          "example": [
            "https://example.com/image1.jpg",
            "https://example.com/mage2.jpg"
          ],
          "items": {
            "type": "string"
          }
        },
        "contactInfo": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "example": "王小明"
            },
            "phone": {
              "type": "string",
              "example": "0912345678"
            },
            "email": {
              "type": "string",
              "example": "ming@gmail.com"
            }
          }
        },
        "location": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "example": "臺北市"
            },
            "dist": {
              "type": "string",
              "example": "信義區"
            },
            "address": {
              "type": "string",
              "example": "臺北市信義區市府路45號"
            }
          }
        }
      }
    },
    "purchasePoints": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "superCoin": {
              "type": "number",
              "example": 750
            },
            "helperCoin": {
              "type": "number",
              "example": 1050
            }
          }
        },
        "message": {
          "type": "string",
          "example": "購買成功"
        }
      }
    },
    "cashbackPoints": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "superCoin": {
              "type": "number",
              "example": 450
            },
            "helperCoin": {
              "type": "number",
              "example": 1050
            }
          }
        },
        "message": {
          "type": "string",
          "example": "返還成功"
        }
      }
    },
    "getNotifyList": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "notifyId": {
              "type": "string",
              "example": "6462e2fbcc60d505cc83de30"
            },
            "userId": {
              "type": "string",
              "example": "646266a3d7d8ce5010f8c327"
            },
            "tag": {
              "type": "string",
              "example": "案主通知"
            },
            "read": {
              "type": "boolean",
              "example": true
            },
            "description": {
              "type": "string",
              "example": "您的任務：「陪我家狗玩 」幫手已提交驗收內容，請進行驗收"
            },
            "taskId": {
              "type": "string",
              "example": "646266a3d7d8ce5010f8c334"
            },
            "createdAt": {
              "type": "string",
              "example": "2022-02-17T05:55:56.000Z"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得通知成功"
        }
      }
    },
    "getTaskQuery": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "tasks": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "taskId": {
                    "type": "string",
                    "example": "648a7db8ecd4a693f8e551da"
                  },
                  "createdAt": {
                    "type": "string",
                    "example": "2023-06-15T02:55:52.574Z"
                  },
                  "publishedAt": {
                    "type": "string",
                    "example": "2023-06-15T02:55:52.574Z"
                  },
                  "expiredAt": {
                    "type": "string",
                    "example": "2023-06-22T02:55:52.574Z"
                  },
                  "updatedAt": {
                    "type": "string",
                    "example": "2023-06-15T02:55:52.574Z"
                  },
                  "status": {
                    "type": "string",
                    "example": "媒合中"
                  },
                  "title": {
                    "type": "string",
                    "example": "幫忙打王國之淚的Boss"
                  },
                  "isUrgent": {
                    "type": "boolean",
                    "example": false
                  },
                  "salary": {
                    "type": "number",
                    "example": 500
                  },
                  "address": {
                    "type": "string",
                    "example": "臺北市信義區基隆路300號"
                  },
                  "category": {
                    "type": "string",
                    "example": "人力派遣"
                  },
                  "description": {
                    "type": "string",
                    "example": "Boss 好難打，急徵高手幫忙，不可以花我太多素材，意者私聊"
                  },
                  "imgUrls": {
                    "type": "array",
                    "example": [
                      "https://storage.googleapis.com/superhandy.appspot.com/images/27cf2428-96dc-48ec-bb50-a14c59b44a5e.jpeg?GoogleAccessId=firebase-adminsdk-xlymb%40superhandy.iam.gserviceaccount.com&Expires=16756646400&Signature=Ev8Mgk1SCQ8CeLj47jlDNJ6M4PU0FJ8LcZk9TMvVPPkFo6KAyod%2B2q8zaV4Hyg7tpKiKKORYxRN0%2FdA7vPMBBzKINxJYpVxMHVg94HmPx1pG28VREk%2FvyHuLiBpHtIfG8gEXFeJbY7%2FJqtLW%2FQDbCK8kKTLwkPRXFlFiAtDl%2BW1KQTu2l%2Bv%2BLvBPpUGYYdR40Wcd%2FYs0tN%2F8kd%2BL7UkKg8iNy3AxPohVlakv5xmHM32VvXWJWoxQ3wuy4FVPZ%2Fpebz7uwkjht5c9YHWol5GddRK%2BPHs5IcpecUvMitIMy%2Fr4tRiouq2Xahv6NqAN317GmsSvxWdKYvxhemNgpbzPKA%3D%3D",
                      "https://storage.googleapis.com/superhandy.appspot.com/images/655c362d-9b8c-4e2f-b289-f75917177525.jpeg?GoogleAccessId=firebase-adminsdk-xlymb%40superhandy.iam.gserviceaccount.com&Expires=16756646400&Signature=kQz1YDHpwhIix8633VWCcYpssme3ldDH3TN5U9hM07Q2zzHy4LMwQEJ8akGegGpAv8vY%2BBGV4aYZ1hY4MiNWNHkafEwR7Wk8VYRMMYFcdeU7NRbv6U%2B5GUJKEFaZFs0xcajp1AJxsIYkuIc4JxqQZnBnhZH7jVBjnaMtWB%2B5WrNLcoRRpdzf64Ngf48KfCUoa7W8xAmTt51OblVX%2FzY1RxY9Q9v8n2PNBAn7Ge2JOLsCYQ%2B9QDMhkxhRefH9aXUkeEkZycstJWxEnm9rpKnmCpkpkrJeSmvw%2BdD42gFA5RVN8UVN%2Fag%2FS1AyRzR2M9RIXMAyVM1wtuX8fhAxRd1oFg%3D%3D",
                      "https://storage.googleapis.com/superhandy.appspot.com/images/5853640a-267a-4a0d-b3d8-30af4785643b.jpeg?GoogleAccessId=firebase-adminsdk-xlymb%40superhandy.iam.gserviceaccount.com&Expires=16756646400&Signature=oIRETi1rIiaNhZUPJTdfvT5CbCYiRjYkZFqIm4pr7L7k%2FkamWokiuN4u42JXW7ud%2Fr%2BotSbU%2BzXbpRt4g9JzZqbA4ax85JZyoSQRKWsyWrx3CI5fexnLlf1u9q8uE2VLAjQyyJqOJol6fcBrzuhAjh25jDyPBwriZiAIOo4pYmdPGfSV1S9jUBgFXqAtZHvA%2BfQtLBc3cyE6viGJv4L5n%2FaZfynMwTZAsb2%2F56bo1z2xJ8guEm4ItjN%2BPLKyZg%2BZENiFoCA5zJ7aihMn%2BzWaPYB1Qkb1RiJakW8xLjEmSvdlLjpl9WaloXwXVQUftjrxuD%2Bm4qvH4pfNy3UsBEWSNA%3D%3D"
                    ],
                    "items": {
                      "type": "string"
                    }
                  },
                  "viewerCount": {
                    "type": "number",
                    "example": 0
                  },
                  "helperCount": {
                    "type": "number",
                    "example": 3
                  },
                  "posterName": {
                    "type": "string",
                    "example": "翁文方"
                  },
                  "contactName": {
                    "type": "string",
                    "example": "翁文方"
                  }
                }
              }
            },
            "page": {
              "type": "number",
              "example": 1
            },
            "limit": {
              "type": "number",
              "example": 10
            },
            "total_pages": {
              "type": "number",
              "example": 1
            },
            "total_tasks": {
              "type": "number",
              "example": 6
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getPostedTasksHist": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "taskId": {
                "type": "string",
                "example": "646431446cac1cf0dd5acaee"
              },
              "title": {
                "type": "string",
                "example": "陪我家狗玩"
              },
              "isUrgent": {
                "type": "boolean",
                "example": true
              },
              "status": {
                "type": "string",
                "example": "已完成"
              },
              "salary": {
                "type": "number",
                "example": 300
              },
              "address": {
                "type": "string",
                "example": "臺北市松山區復興北路15號"
              },
              "createdAt": {
                "type": "string",
                "example": "2023-01-30T04:34:56.000Z"
              },
              "publishedAt": {
                "type": "string",
                "example": "2022-02-15T05:34:56.000Z"
              },
              "expiredAt": {
                "type": "string",
                "example": "2023-03-01T04:34:56.000Z"
              },
              "helper": {
                "type": "string",
                "example": "張亞靜"
              },
              "imgUrls": {
                "type": "array",
                "example": [
                  "https://example.com/image1.jpg",
                  "https://example.com/mage2.jpg"
                ],
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getAppliedTasksHist": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "taskId": {
                "type": "string",
                "example": "646431446cac1cf0dd5acaee"
              },
              "title": {
                "type": "string",
                "example": "幫忙做畢業專題"
              },
              "isUrgent": {
                "type": "boolean",
                "example": false
              },
              "status": {
                "type": "string",
                "example": "已完成"
              },
              "helperStatus": {
                "type": "string",
                "example": "媒合成功"
              },
              "salary": {
                "type": "number",
                "example": 300
              },
              "address": {
                "type": "string",
                "example": "臺北市松山區羅斯福路四段1號"
              },
              "createdAt": {
                "type": "string",
                "example": "2023-01-30T04:34:56.000Z"
              },
              "publishedAt": {
                "type": "string",
                "example": "2022-02-15T05:34:56.000Z"
              },
              "expiredAt": {
                "type": "string",
                "example": "2023-03-01T04:34:56.000Z"
              },
              "poster": {
                "type": "string",
                "example": "張亞靜"
              },
              "imgUrls": {
                "type": "array",
                "example": [
                  "https://example.com/image1.jpg",
                  "https://example.com/mage2.jpg"
                ],
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getTaskDetails": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "taskId": {
              "type": "string",
              "example": "646431446cac1cf0dd5acaee"
            },
            "role": {
              "type": "string",
              "example": "案主"
            },
            "publishedAt": {
              "type": "string",
              "example": "2022-02-15T05:34:56.000Z"
            },
            "expiredAt": {
              "type": "string",
              "example": "2023-03-15T02:55:52.574Z"
            },
            "status": {
              "type": "string",
              "example": "已完成"
            },
            "statusReason": {
              "type": "string",
              "example": ""
            },
            "helper": {
              "type": "string",
              "example": "陳瑋宇"
            },
            "poster": {
              "type": "string",
              "example": "翁文方"
            },
            "progressBar": {
              "type": "object",
              "properties": {
                "publishedAt": {
                  "type": "string",
                  "example": "2022-02-15T05:34:56.000Z"
                },
                "inProgressAt": {
                  "type": "string",
                  "example": "2022-02-16T05:34:56.000Z"
                },
                "submittedAt": {
                  "type": "string",
                  "example": "2022-02-17T05:55:56.000Z"
                },
                "confirmedAt": {
                  "type": "string",
                  "example": "2022-02-19T11:15:50.000Z"
                },
                "completedAt": {
                  "type": "string",
                  "example": "2022-02-23T00:19:50.000Z"
                }
              }
            },
            "title": {
              "type": "string",
              "example": "陪我家狗玩"
            },
            "isUrgent": {
              "type": "boolean",
              "example": true
            },
            "salary": {
              "type": "number",
              "example": 300
            },
            "exposurePlan": {
              "type": "string",
              "example": "黃金曝光"
            },
            "location": {
              "type": "object",
              "properties": {
                "city": {
                  "type": "string",
                  "example": "臺北市"
                },
                "dist": {
                  "type": "string",
                  "example": "松山區"
                },
                "address": {
                  "type": "string",
                  "example": "復興北路15號"
                }
              }
            },
            "category": {
              "type": "string",
              "example": "寵物陪伴"
            },
            "description": {
              "type": "string",
              "example": "我家有黃金獵犬，但我這禮拜很忙，請幫我 2/20 早上 8 點來歌唱大樓找我，並帶他去附近公園陪他散步"
            },
            "imgUrls": {
              "type": "array",
              "example": [
                "https://example.com/dog.jpg"
              ],
              "items": {
                "type": "string"
              }
            },
            "helpers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "helperId": {
                    "type": "string",
                    "example": "648a7db8ecd4a693f8e551cd"
                  },
                  "helperSkills": {
                    "type": "array",
                    "example": [
                      "居家服務",
                      "清潔外包"
                    ],
                    "items": {
                      "type": "string"
                    }
                  },
                  "status": {
                    "type": "string",
                    "example": "等待媒合中"
                  },
                  "lastName": {
                    "type": "string",
                    "example": "翁"
                  },
                  "completedTasks": {
                    "type": "number",
                    "example": 1
                  },
                  "completionRate": {
                    "type": "number",
                    "example": 100
                  },
                  "rating": {
                    "type": "object",
                    "properties": {
                      "overall": {
                        "type": "number",
                        "example": 4
                      },
                      "categories": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "example": "寵物陪伴"
                            },
                            "star": {
                              "type": "number",
                              "example": 4
                            },
                            "totalReviews": {
                              "type": "number",
                              "example": 1
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            },
            "contactInfo": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "example": "翁文方"
                },
                "phone": {
                  "type": "string",
                  "example": "0932345678"
                },
                "email": {
                  "type": "string",
                  "example": "user1@example.com"
                }
              }
            },
            "submittedInfo": {
              "type": "object",
              "properties": {
                "imgUrls": {
                  "type": "array",
                  "example": [],
                  "items": {}
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "uploadAcceptanceReq": {
      "type": "object",
      "properties": {
        "submittedInfo": {
          "type": "object",
          "properties": {
            "imgUrls": {
              "type": "array",
              "example": [
                "http://example.com/1.jpg"
              ],
              "items": {
                "type": "string"
              }
            },
            "comment": {
              "type": "string",
              "example": "好多人好難排，但我拿到了"
            }
          }
        }
      }
    },
    "refuseAcceptanceReq": {
      "type": "object",
      "properties": {
        "submittedInfo": {
          "type": "object",
          "properties": {
            "imgUrls": {
              "type": "array",
              "example": [
                "http://example.com/1.jpg"
              ],
              "items": {
                "type": "string"
              }
            },
            "comment": {
              "type": "string",
              "example": "你給的有瑕疵不能玩啊"
            }
          }
        }
      }
    },
    "findTaskDetails": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "taskId": {
              "type": "string",
              "example": "646431446cac1cf0dd5acaee"
            },
            "publishedAt": {
              "type": "string",
              "example": "2022-02-15T05:34:56.000Z"
            },
            "status": {
              "type": "string",
              "example": "已完成"
            },
            "progressBar": {
              "type": "object",
              "properties": {
                "publishedAt": {
                  "type": "string",
                  "example": "2022-02-15T05:34:56.000Z"
                },
                "inProgressAt": {
                  "type": "string",
                  "example": "2022-02-16T05:34:56.000Z"
                },
                "submittedAt": {
                  "type": "string",
                  "example": "2022-02-17T05:55:56.000Z"
                },
                "confirmedAt": {
                  "type": "string",
                  "example": "2022-02-19T11:15:50.000Z"
                },
                "completedAt": {
                  "type": "string",
                  "example": "2022-02-23T00:19:50.000Z"
                }
              }
            },
            "title": {
              "type": "string",
              "example": "陪我家狗玩"
            },
            "isUrgent": {
              "type": "boolean",
              "example": true
            },
            "salary": {
              "type": "number",
              "example": 300
            },
            "address": {
              "type": "string",
              "example": "臺北市松山區復興北路15號"
            },
            "category": {
              "type": "string",
              "example": "寵物陪伴"
            },
            "description": {
              "type": "string",
              "example": "我家有黃金獵犬，但我這禮拜很忙，請幫我 2/20 早上 8 點來歌唱大樓找我，並帶他去附近公園陪他散步"
            },
            "imgUrls": {
              "type": "array",
              "example": [
                "https://example.com/dog.jpg"
              ],
              "items": {
                "type": "string"
              }
            },
            "viewerCount": {
              "type": "number",
              "example": 1
            },
            "posterInfo": {
              "type": "object",
              "properties": {
                "lastName": {
                  "type": "string",
                  "example": "陳"
                },
                "phone": {
                  "type": "string",
                  "example": "0919******"
                },
                "email": {
                  "type": "string",
                  "example": "*****@********"
                }
              }
            },
            "contactInfo": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "example": "陳瑋宇"
                },
                "phone": {
                  "type": "string",
                  "example": "0919694069"
                },
                "email": {
                  "type": "string",
                  "example": ""
                }
              }
            },
            "relation": {
              "type": "string",
              "example": "poster"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "findTaskListGeneral": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "tasks": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "taskId": {
                    "type": "string",
                    "example": "645bec484ff0061f89e0b103"
                  },
                  "publishedAt": {
                    "type": "string",
                    "example": "2023-05-10T19:11:04.653Z"
                  },
                  "status": {
                    "type": "string",
                    "example": "媒合中"
                  },
                  "title": {
                    "type": "string",
                    "example": "任務標題"
                  },
                  "isUrgent": {
                    "type": "boolean",
                    "example": false
                  },
                  "salary": {
                    "type": "number",
                    "example": 1000
                  },
                  "address": {
                    "type": "string",
                    "example": "臺北市信義區"
                  },
                  "category": {
                    "type": "string",
                    "example": "家事"
                  },
                  "description": {
                    "type": "string",
                    "example": "任務描述"
                  },
                  "imgUrls": {
                    "type": "string",
                    "example": ""
                  },
                  "viewerCount": {
                    "type": "number",
                    "example": 0
                  },
                  "helperCount": {
                    "type": "number",
                    "example": 0
                  },
                  "posterName": {
                    "type": "string",
                    "example": "王**"
                  },
                  "contactName": {
                    "type": "string",
                    "example": "王**"
                  }
                }
              }
            },
            "page": {
              "type": "number",
              "example": 1
            },
            "limit": {
              "type": "number",
              "example": 6
            },
            "total_pages": {
              "type": "number",
              "example": 1
            },
            "total_tasks": {
              "type": "number",
              "example": 5
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "findTaskListMap": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "tasks": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "taskId": {
                    "type": "string",
                    "example": "645bec484ff0061f89e0b103"
                  },
                  "publishedAt": {
                    "type": "string",
                    "example": "2023-05-10T19:11:04.653Z"
                  },
                  "status": {
                    "type": "string",
                    "example": "媒合中"
                  },
                  "title": {
                    "type": "string",
                    "example": "任務標題"
                  },
                  "isUrgent": {
                    "type": "boolean",
                    "example": false
                  },
                  "salary": {
                    "type": "number",
                    "example": 1000
                  },
                  "address": {
                    "type": "string",
                    "example": "臺北市信義區"
                  },
                  "category": {
                    "type": "string",
                    "example": "家事"
                  },
                  "description": {
                    "type": "string",
                    "example": "任務描述"
                  },
                  "location": {
                    "type": "object",
                    "properties": {
                      "city": {
                        "type": "string",
                        "example": "臺北市"
                      },
                      "dist": {
                        "type": "string",
                        "example": "信義區"
                      },
                      "address": {
                        "type": "string",
                        "example": "松智路17號"
                      },
                      "longitude": {
                        "type": "number",
                        "example": 121.53868
                      },
                      "latitude": {
                        "type": "number",
                        "example": 25.02697
                      },
                      "landmark": {
                        "type": "string",
                        "example": ""
                      }
                    }
                  },
                  "viewerCount": {
                    "type": "number",
                    "example": 0
                  },
                  "helperCount": {
                    "type": "number",
                    "example": 0
                  },
                  "posterName": {
                    "type": "string",
                    "example": "王**"
                  },
                  "contactName": {
                    "type": "string",
                    "example": "王**"
                  }
                }
              }
            },
            "total_tasks": {
              "type": "number",
              "example": 1
            },
            "longitude": {
              "type": "number",
              "example": 121.5720055
            },
            "latitude": {
              "type": "number",
              "example": 25.0409201
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "findTaskListHighlight": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "tasks": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "taskId": {
                    "type": "string",
                    "example": "645bec484ff0061f89e0b103"
                  },
                  "title": {
                    "type": "string",
                    "example": "任務標題"
                  },
                  "imgUrls": {
                    "type": "string",
                    "example": ""
                  }
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "ratingAndReviewReq": {
      "type": "object",
      "properties": {
        "star": {
          "type": "number",
          "example": 4
        },
        "comment": {
          "type": "string",
          "example": "幫手表現超棒der"
        }
      }
    },
    "getCommentsHist": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "yourStar": {
                "type": "number",
                "example": 5
              },
              "category": {
                "type": "string",
                "example": "寵物陪伴"
              },
              "title": {
                "type": "string",
                "example": "陪我家狗玩"
              },
              "address": {
                "type": "string",
                "example": "臺北市松山區復興北路15號"
              },
              "salary": {
                "type": "number",
                "example": 300
              },
              "name": {
                "type": "string",
                "example": "陳瑋宇"
              },
              "publishedAt": {
                "type": "string",
                "example": "2022-02-15T05:34:56.000Z"
              },
              "confirmedAt": {
                "type": "string",
                "example": "2023-05-19T11:15:50.000Z"
              },
              "helperReview": {
                "type": "object",
                "properties": {
                  "star": {
                    "type": "number",
                    "example": 5
                  },
                  "status": {
                    "type": "string",
                    "example": "已評價"
                  },
                  "comment": {
                    "type": "string",
                    "example": "案主態度好，狗好很帶"
                  }
                }
              },
              "posterReview": {
                "type": "object",
                "properties": {
                  "star": {
                    "type": "number",
                    "example": 4
                  },
                  "status": {
                    "type": "string",
                    "example": "已評價"
                  },
                  "comment": {
                    "type": "string",
                    "example": "早上八點有點遲到，讓我等了十分鐘"
                  }
                }
              },
              "taskId": {
                "type": "string",
                "example": "646c280234ecc5e9e7aef1ce"
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "getStarCounts": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "1": {
              "type": "number",
              "example": 0
            },
            "2": {
              "type": "number",
              "example": 0
            },
            "3": {
              "type": "number",
              "example": 0
            },
            "4": {
              "type": "number",
              "example": 1
            },
            "5": {
              "type": "number",
              "example": 2
            },
            "null": {
              "type": "number",
              "example": 0
            },
            "avg": {
              "type": "number",
              "example": 4.67
            },
            "totalCount": {
              "type": "number",
              "example": 3
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    },
    "uploadImage": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "imgUrl": {
              "type": "string",
              "example": "https://storage.googleapis.com"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "圖片上傳成功"
        }
      }
    },
    "paymentRequest": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "redirectURL": {
              "type": "string",
              "example": "https://sandbox-web-pay.line.me/web/payment/wait?transactionReserveId=b2VkZGFnZzk3MUo0a3dUY1VLeGs2QVFvalpvellOKzBnZWU1amRlSWlUUi8zSW40M21JelUwU29sQU5TOTRwQw"
            },
            "orderId": {
              "type": "string",
              "example": "6472c92c0234f38138f4c23e-1685244464"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "建立 linepay 訂單成功"
        }
      }
    },
    "getChatRoomList": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "taskId": {
              "type": "string",
              "example": "647a926ba395c8322f620164"
            },
            "title": {
              "type": "string",
              "example": "任務標題"
            },
            "selfRole": {
              "type": "string",
              "example": "helper"
            },
            "partnerRole": {
              "type": "string",
              "example": "poster"
            },
            "poster": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "example": "文芳"
                },
                "lastName": {
                  "type": "string",
                  "example": "翁"
                },
                "nickname": {
                  "type": "string",
                  "example": "小文"
                },
                "avatarPath": {
                  "type": "string",
                  "example": "https://storage.googleapis.com/images/231432424.jpg"
                }
              }
            },
            "helper": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "example": "冠伶"
                },
                "lastName": {
                  "type": "string",
                  "example": "都"
                },
                "nickname": {
                  "type": "string",
                  "example": "滴妹"
                },
                "avatarPath": {
                  "type": "string",
                  "example": "https://storage.googleapis.com/images/231432425.jpg"
                }
              }
            },
            "unreadCount": {
              "type": "number",
              "example": 0
            },
            "lastMessage": {
              "type": "string",
              "example": "最後一則訊息"
            },
            "updatedAt": {
              "type": "string",
              "example": "2021-09-27T07:00:00.000Z"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得聊天室列表成功"
        }
      }
    },
    "getChatHistory": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "taskId": {
              "type": "string",
              "example": "647a926ba395c8322f620164"
            },
            "role": {
              "type": "string",
              "example": "helper"
            },
            "message": {
              "type": "string",
              "example": "罐頭訊息，罐頭罐頭..."
            },
            "createdAt": {
              "type": "string",
              "example": "2021-09-27T07:00:00.000Z"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得聊天室歷史訊息成功"
        }
      }
    },
    "googleCallback": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "oauth_register": {
              "type": "boolean",
              "example": true
            },
            "token": {
              "type": "string",
              "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0ODAwOGYxMDc4ZmMxYWEyZDNlNjU3OSIsImlhdCI6MTY4NjExMzY5MSwiZXhwIjoxNjg2NzE4NDkxfQ.MzuEB6mU7VOVeTIx9In7EYKPKbIwimKZd1eN7bEC9UE"
            },
            "userId": {
              "type": "string",
              "example": "648008f1078fc1aa2d3e6579"
            },
            "nickname": {
              "type": "string",
              "example": "小明"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "第三方登入 - 取得google 資訊"
        }
      }
    },
    "googleSignUp": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "object",
          "properties": {
            "token": {
              "type": "string",
              "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0ODAwOGYxMDc4ZmMxYWEyZDNlNjU3OSIsImlhdCI6MTY4NjExMzY5MSwiZXhwIjoxNjg2NzE4NDkxfQ.MzuEB6mU7VOVeTIx9In7EYKPKbIwimKZd1eN7bEC9UE"
            },
            "userId": {
              "type": "string",
              "example": "648008f1078fc1aa2d3e6579"
            }
          }
        },
        "message": {
          "type": "string",
          "example": "第三方登入 google - 註冊"
        }
      }
    },
    "getPointsHistory": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "tag": {
                "type": "string",
                "example": "刊登任務"
              },
              "taskId": {
                "type": "string",
                "example": "64869b36f50efe405623a154"
              },
              "taskTitle": {
                "type": "string",
                "example": "需求短期家庭清潔工"
              },
              "money": {
                "type": "object",
                "properties": {
                  "salary": {
                    "type": "number",
                    "example": 350
                  },
                  "exposurePlan": {
                    "type": "number",
                    "example": 50
                  },
                  "platform": {
                    "type": "number",
                    "example": 0
                  },
                  "superCoin": {
                    "type": "number",
                    "example": -350
                  },
                  "helperCoin": {
                    "type": "number",
                    "example": -50
                  }
                }
              },
              "desc": {
                "type": "array",
                "example": [
                  "預扣薪水",
                  "黃金曝光"
                ],
                "items": {
                  "type": "string"
                }
              },
              "role": {
                "type": "string",
                "example": "案主"
              },
              "createdAt": {
                "type": "string",
                "example": "2023-06-12T04:12:38.764Z"
              }
            }
          }
        },
        "message": {
          "type": "string",
          "example": "取得成功"
        }
      }
    }
  }
}