桃園市科展報名系統
後端連線
Base URL
儲存 Base URL
所有請求會使用
credentials: include
（Cookie 驗證）。
Captcha
簽發驗證碼
captchaId
captchaAnswer
API：
GET /api/Captcha/issue
（支援回傳 base64 字串或 JSON）。
Auth - 一般登入
userNameOrEmail
password
登入（POST /api/Auth/login）
Auth - 註冊
userName
email
password
role（角色代碼）
name（可選）
schoolCode（可選）
schoolName（可選）
schoolDistrict（可選）
註冊（POST /api/Auth/register）
Auth - 個人資料更新
userName
email
name
schoolCode
schoolName
schoolDistrict
educationStage
department
mobilePhone
schoolPhone
departmentPhone
bio
取得目前資料（GET /api/Auth/profile）
更新個人資料（POST /api/Auth/profile）
Auth - 登出
登出（POST /api/Auth/logout）
Auth - 變更密碼
currentPassword
newPassword
captchaId / captchaAnswer 會沿用上方 Captcha 欄位。
變更密碼（POST /api/Auth/changepassword）
SchoolLookup
載入 SchoolLookup（GET /api/SchoolLookup）
行政區
學習階段
學校
SubjectLookup
載入 SubjectLookup（GET /api/SubjectLookup）
Announcements（前台）
公告列表（GET /api/announcements）
id
取得公告（GET /api/announcements/{id}）
attachmentId
下載附件（GET /api/announcements/attachments/{attachmentId}/download）
下載會以臨時連結觸發瀏覽器儲存。
Announcements 管理
公告列表（GET /api/admin/announcements）
Title
Content
StartAt（UTC）
EndAt（UTC，可空）
IsPinned
IsVisible
PermissionRules（可複選，未選代表公開）
User（學校/一般登入）
Admin（系統管理者）
Reviewer（評審）
Visitor（訪客皆可閱覽）
固定四個角色，送出時會組成 PermissionRules 陣列
Attachments
新增公告（POST /api/admin/announcements）
id（路徑參數）
Title
Content
StartAt（UTC）
EndAt（UTC，可空）
IsPinned
IsVisible
PermissionRules（可複選，覆蓋，未選代表公開）
User（學校/一般登入）
Admin（系統管理者）
Reviewer（評審）
Visitor（訪客皆可閱覽）
固定四個角色，送出時會覆蓋 PermissionRules
NewAttachments
RemoveAttachmentIds（逗號分隔）
更新公告（POST /api/admin/announcements/{id}）
announcementIds（逗號分隔）
批次刪除（POST /api/admin/announcements/batch/delete）
JudgePermissions
userId（可選）
stageId（可選）
subjectId（可選）
查詢清單（GET /api/JudgePermissions）
id
取得單筆（GET /api/JudgePermissions/{id}）
userId
stageId
subjectId
isEnabled
新增/更新（POST /api/JudgePermissions）
Users 管理
使用者列表（GET /api/Users）
userId（路徑參數）
userName
email
name
schoolCode
schoolName
schoolDistrict
educationStage
department
mobilePhone
schoolPhone
departmentPhone
bio
role
status
更新使用者（POST /api/Users/{userId}）
userIds（逗號分隔）
批次刪除（POST /api/Users/batch/delete）
userIds（逗號分隔）
disabledStatus（可選，預設 0）
批次停權（POST /api/Users/batch/disable）
userIds（逗號分隔）
enabledStatus（可選，預設 4）
批次啟用（POST /api/Users/batch/enable）
userIds（逗號分隔）
newPassword
批次重設密碼（POST /api/Users/batch/resetpassword）
Auth - 參賽學校登入
password
學校登入（POST /api/Auth/loginschool）
行政區/階段/學校名稱取自上方 SchoolLookup 下拉。
SystemSetting 管理
載入設定（GET /api/SystemSetting）
editionId
editionName
systemTitle
reportTitle
isActive
juniorIsEnabled
juniorRegistrationStartAt
juniorRegistrationEndAt
juniorUploadStartAt
juniorUploadEndAt
juniorPreliminarySupplementStartAt
juniorPreliminarySupplementEndAt
juniorPreliminaryReviewStartAt
juniorPreliminaryReviewEndAt
juniorFinalLoginStartAt
juniorFinalLoginEndAt
juniorFinalSupplementStartAt
juniorFinalSupplementEndAt
juniorFinalReviewStartAt
juniorFinalReviewEndAt
juniorFinalCanOverwritePreliminaryFile
seniorIsEnabled
seniorRegistrationStartAt
seniorRegistrationEndAt
seniorUploadStartAt
seniorUploadEndAt
seniorSupplementStartAt
seniorSupplementEndAt
seniorFinalReviewStartAt
seniorFinalReviewEndAt
儲存設定（POST /api/SystemSetting）
WorksRegistration（學校端）
作品清單（GET /api/registrations/works）
建立作品
subjectId
workName
workResearchStart
workResearchEnd
isOtherCompetition
isContinuingResearch
schoolPostalCode
schoolAddress
firstAuthorPhone
authors（JSON 陣列）
advisors（JSON 陣列）
consultants（JSON 陣列）
建立（POST /api/registrations/works）
更新作品
id（路徑參數）
subjectId
workName
workResearchStart
workResearchEnd
isOtherCompetition
isContinuingResearch
schoolPostalCode
schoolAddress
firstAuthorPhone
authors（JSON 陣列）
advisors（JSON 陣列）
consultants（JSON 陣列）
更新（POST /api/registrations/works/{id}）
查詢單筆
id
取得（GET /api/registrations/works/{id}）
刪除作品
id
刪除（DELETE /api/registrations/works/{id}）
注意：此操作為物理刪除作品主檔及其所有關聯資料。
上傳作品附件（PDF）
id（作品 ID）
CategoryId（WorkFileCategory 1-12）
File
上傳（POST /api/registrations/works/{id}/files）
刪除作品附件
id（作品 ID）
fileId
刪除（POST /api/registrations/works/{id}/files/{fileId}）
下載作品附件
fileId
下載（GET /api/registrations/works/files/{fileId}/download）
提交作品
id
提交（POST /api/registrations/works/{id}/submit）
批次報名（Excel）
ExcelFile
上傳（POST /api/registrations/works/batch）
下載空白範本
templateKey (1-24)
下載（GET /api/registrations/templates/{templateKey}）
匯出學校作品送展清冊
匯出（GET /api/registrations/works/export/schoollist）
匯出作品數量統計表
匯出（GET /api/registrations/works/export/workcountsummary）
匯出作品報名表
workIds（逗號分隔）
匯出（GET /api/registrations/export/submissionforms）
上傳學校文件
DocumentType（WorkFileCategory 1-12）
File
上傳（POST /api/registrations/uploadschooldocuments）
下載學校文件
categoryId
下載（GET /api/registrations/downloadschooldocuments/{categoryId}）
刪除學校文件
categoryId
刪除（POST /api/registrations/deleteschooldocuments/{categoryId}）
WorksAdmin（管理端）
subjectId（可選）
workName（可選）
authorName（可選）
advisorName（可選）
查詢（GET /api/admin/works）
workId
取得單筆（GET /api/admin/works/{workId}）
fileId
下載附件（GET /api/admin/works/files/{fileId}/download）
下載學校文件（管理端）
userId
categoryId（WorkFileCategory 1-12）
下載（GET /api/admin/works/schools/{userId}/documents/{categoryId}/download）
WeatherForecast（範例/測試用）
取得 WeatherForecast（GET /api/WeatherForecast）
輸出
清除輸出