廟務系統 (1.0)

Download OpenAPI specification:Download

Authentication

AdminAuth

Security Scheme Type HTTP
HTTP Authorization Scheme bearer
Bearer format "JWT"

User

使用者 API

登出

登出

Responses

後台登入

Request Body schema: application/json
username
required
string

帳號

password
required
string

密碼

Responses

Request samples

Content type
application/json
{
  • "username": "string",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "token": "string"
}

驗證 User

Authorizations:

Responses

Members

會員 API

編輯會員

編輯會員

Authorizations:
path Parameters
memberId
required
number

會員 id

Request Body schema: application/json
name
string

姓名

mobile
string

手機電話

address
string

地址

gender
string
Enum: "male" "female"

性別

panguFamily
boolean

盤古家族成員

birthday
string <date-time>

生日

birthdayType
string
Enum: "solar" "lunar"

出生年月日種類:

  • solar: 國曆
  • lunar: 農曆
mainContact
boolean

主要聯絡人

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "mobile": "string",
  • "address": "string",
  • "gender": "male",
  • "panguFamily": true,
  • "birthday": "2019-08-24T14:15:22Z",
  • "birthdayType": "solar",
  • "mainContact": true
}

取得會員明細資料

取得會員明細資料

Authorizations:
path Parameters
memberId
required
number

會員 id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "memberNo": "string",
  • "name": "string",
  • "mobile": "string",
  • "address": "string",
  • "gender": "male",
  • "panguFamily": true,
  • "solarBirthday": "2019-08-24T14:15:22Z",
  • "lunarBirthday": "2019-08-24T14:15:22Z",
  • "zodiac": "string",
  • "mainContact": true,
  • "enable": true,
  • "familyMembers": [
    ]
}

匯入會員資料

匯入會員資料

Authorizations:
Request Body schema: multipart/form-data
socketClientId
string

socket id

file
string <binary>

Responses

啟用帳號

啟用帳號

Authorizations:
Request Body schema: application/json
ids
Array of integers[ items ]

帳號 id

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ]
}

停用帳號

停用帳號

Authorizations:
Request Body schema: application/json
ids
Array of integers[ items ]

帳號 id

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ]
}

取得會員列表

取得會員列表

Authorizations:
query Parameters
sorter
string
Example: sorter=name.asc

排序, 格式: {columnName}.{asc | desc}

pageIndex
required
number

目前分頁位置

countPerPage
required
number

每頁資料數量

mobile
string

手機電話號碼(可模糊查詢)

name
string

姓名(可模糊查詢)

panguFamily
boolean

是否盤古家族成員

gender
string
Enum: "male" "female"

性別

address
string

地址 (可模糊查詢)

enable
boolean

帳號啟用狀態

includeMemberIds
Array of integers[ items ]

包含在搜尋結果內的會員 id

strictSearch
string
Example: strictSearch=address

嚴格搜尋,格式: {columnName} support: address

Responses

Response samples

Content type
application/json
{
  • "totalPage": 0,
  • "currentPageIndex": 0,
  • "totalCount": 0,
  • "records": [
    ]
}

新增會員

新增會員

Authorizations:
Request Body schema: application/json
name
required
string

姓名

mobile
required
string

手機電話

address
required
string

地址

gender
required
string
Enum: "male" "female"

性別

panguFamily
required
boolean

盤古家族成員

birthday
required
string <date-time>

生日

birthdayType
required
string
Enum: "solar" "lunar"

出生年月日種類:

  • solar: 國曆
  • lunar: 農曆
mainContact
boolean

主要聯絡人

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "mobile": "string",
  • "address": "string",
  • "gender": "male",
  • "panguFamily": true,
  • "birthday": "2019-08-24T14:15:22Z",
  • "birthdayType": "solar",
  • "mainContact": true
}

Response samples

Content type
application/json
Example
{
  • "code": 400001,
  • "message": "錯誤的日期格式"
}

Activities

活動 API

修改活動類別

修改活動類別

Authorizations:
path Parameters
categoryId
required
number

類別 id

Request Body schema: application/json
name
string

活動名稱

signUpUnitType
string

報名單位類型

autoGenerateSerialNumber
boolean

自動產生單位序號

oneUnitPerPerson
boolean

自動設定一人一單位

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "signUpUnitType": "string",
  • "autoGenerateSerialNumber": true,
  • "oneUnitPerPerson": true
}

取得活動類別明細

取得活動類別明細

Authorizations:
path Parameters
categoryId
required
number

類別 id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "signUpUnitType": "string",
  • "autoGenerateSerialNumber": true,
  • "oneUnitPerPerson": true
}

編輯活動報名會員明細資料

編輯活動報名會員明細資料

Authorizations:
path Parameters
signUpMemberId
required
number

報名會員 id

Request Body schema: application/json
signUpUnit
number

報名單位

amount
number

報名金額

memberId
number

會員 id

Array of objects[ items ]

備註

Responses

Request samples

Content type
application/json
{
  • "signUpUnit": 0,
  • "amount": 0,
  • "memberId": 0,
  • "remarks": [
    ]
}

取得活動報名會員明細資料

取得活動報名會員明細資料

Authorizations:
path Parameters
signUpMemberId
required
number

報名會員 id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "member": {
    },
  • "activity": {
    },
  • "totalUnit": 0,
  • "amount": 0,
  • "sequence": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "remarks": [
    ]
}

取得活動備註

取得活動備註

Authorizations:

Responses

Response samples

Content type
application/json
[
  • {
    }
]

刪除活動類別

刪除活動類別

Authorizations:
query Parameters
ids
Array of numbers[ items ]

欲刪除的 id

Responses

取得活動類別列表

取得活動類別列表

Authorizations:
query Parameters
sorter
string
Example: sorter=name.asc

排序, 格式: {columnName}.{asc | desc}

pageIndex
required
number

目前分頁位置

countPerPage
required
number

每頁資料數量

Responses

Response samples

Content type
application/json
{
  • "totalPage": 0,
  • "currentPageIndex": 0,
  • "totalCount": 0,
  • "records": [
    ]
}

新增活動類別

新增活動類別

Authorizations:
Request Body schema: application/json
name
required
string

活動名稱

signUpUnitType
required
string

報名單位類型

autoGenerateSerialNumber
boolean

自動產生單位序號

oneUnitPerPerson
boolean

自動設定一人一單位

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "signUpUnitType": "string",
  • "autoGenerateSerialNumber": true,
  • "oneUnitPerPerson": true
}

編輯活動

編輯活動

Authorizations:
path Parameters
activityId
required
string

活動 id

Request Body schema: application/json
name
string

活動名稱

categoryId
number

活動類別 id

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "categoryId": 0
}

取得活動明細

取得活動明細

Authorizations:
path Parameters
activityId
required
string

活動 id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name"