Please enable JavaScript.
Coggle requires JavaScript to display documents.
台北通-市府集章活動 - Coggle Diagram
台北通-市府集章活動
GET :check:
CheckIn/ActivityUserInfo
取得活動及使用者集章狀態資訊
以使用者id及活動id查詢該活動資訊及使用者集章資訊
Request
Header
Content-Type:application/json
Body
uuid:string
使用者id
activityId:int
活動資訊id
Response 200
status:int
狀態類別
成功: 0
無資料: 1
status_desc
狀態描述
成功: "成功"
無資料: "無此活動資料"
data:object
activity_startDate
活動開始時間(timestamp)
activity_endDate
活動結束時間(timestamp)
activity_name
活動名稱
activity_timeLeft
活動剩餘時間(timestamp)
activity_id
活動編號
activity_reedemCode
活動兌換碼
loyaltyCard_status
集章狀態
spot_id
站點編號
spot_name
站點名稱
completed_status
站點集章完成狀態(true:已完成, false:未完成)
loyaltyCard_process
集章進度
completed
已集滿章數
remaining
剩餘章數
lotteryTicket_quota_act
使用者活動剩餘抽獎額度
lotteryTicket_quota_today
使用者本日剩餘抽獎額度
lotteryTicket_notRedeemed
尚未抽獎兌獎數量
Response 401
查無內容
Response 500
服務異常
GET :check:
lotteryTicket
使用者抽獎兌獎資料
Request
activityId
status
uuid
Response
200
status_desc
data
lotteryTicketCode
抽獎兌獎代碼
status
2 (已抽獎兌獎)
3 (已過期)
1 (未抽獎兌獎)
create_time
抽獎兌獎券獲得時間(timestamp)
status
狀態類別
成功: 0
無資料: 1
401查無內容
500 服務異常
POST :check:
lotteryTicket
寫入使用者於指定活動中的抽獎兌獎資料
Request
Header
Content-Type:application/json
Body
lotteryTicketCode
抽獎兌獎代碼
redeemCode
活動兌換碼(若活動不需兌換碼則空白)
Response
status
狀態類別
成功: 0
失敗/兌換碼錯誤/資料異常: 1
status_desc
狀態描述
server
正式機
QR-code
https://id.taipei/tpcd/taipeipass-app/scan?type=verify_fetch_callback&id=30f9f649-150e-451d-8ad0-768e6f4faef6&ActivityId={ActivityId}&Spot={Spot}&checkCode={checkCode}
測試機
QR-code
https://demo.jrsys.com.tw/tpcd/taipeipass-app/scan?type=verify_fetch_callback&id=4d146ad9-619b-4536-b5bc-71b7fd172d3d&ActivityId={ActivityId}&Spot={Spot}&checkCode={checkCode}
http://210.69.38.117:5010/CheckIn/callback
https://demo.jrsys.com.tw/tpcd/service/v1.0.2/verify/p7signature/user
GET :check:CheckIn/CreateDB
系統初始化建資料表使用
GET
Response
OK
GET :check:CheckIn/QrCode
產生市府集章QrCode
GET
Request
activityId:int
spot:int
Response
200
QrCode Url
POST :check:CheckIn/fetch
自訂台北通QR Code內容
回覆自訂台北通QR Code內容及CallBackURL
Post
Request
Header:
Content-Type:application/json
Body
params:object
ActivityId
Spot
Response
200
CheckInResponseModel
comment:CheckInCommentModel
內容用途(將顯示於個人數位足跡)
en
zh_tw
callbackUrl:string
回呼存取端口，用於接收台北通APP簽章值
type:string
台北通平台參數(verify_fetch_callback)
expiration:long
timestamp到期時間，不填則不限制
data:CheckInDataModel
自訂簽章內容
ActivityId:
申請的自訂參數_活動ID
Spot:string
申請的自訂參數_站點
GET :check:CheckIn/CallBack
接收台北通QR Code簽章
Post
Request
Header
Content-Type:application/x-www-form-urlencoded
Body
data:string
台北通APP傳送的簽章值
Response
200
*type:string
*status:int
0:錯誤
1:正確
2:警告
*title:string
活動已結束
已達本日完成次數上限
重複集章
集章失敗
集章成功
content:string
此活動已結束，可至xxx網站查看抽獎結果。
每人每日至多可獲得" + {$CheckIn_Activity.numOfDay} +"抽獎機會
您已收集過此QRCode，請至其它集章點位繼續完成活動。
請重新再試一次