...
USD
Jplander activity hub

根域名入口页已经切回正式首页

这里保留最常用的几个入口,不再直接显示 README。管理员登录、前端联调、接口文档和 LINE 授权测试都可以从这里直接进入。

基础地址:https://api.rgun9.top 前端鉴权:Bearer Token 抽奖流程:先绑定码再抽奖
管理后台

管理员登录

进入后台控制台,处理候选人、报名记录、投票记录、奖品和中奖码等运营数据。

打开后台登录
前端接口

前端 API 文档

按真实调用顺序整理好的前端接口文档,涵盖 LINE 登录、报名、投票、绑定抽奖码和抽奖。

查看前端文档
后台接口

后台 API 文档

管理员后台联调用文档,包含活动概览、用户管理、候选人管理、奖品和中奖码管理等接口。

查看后台文档
联调工具

LINE 授权测试

用于本地或线上联调 LINE 登录链路,检查 prepare、callback、auth_code 和 token 交换是否正常。

打开测试页
候选人详情

人物介绍页面

查看候选人介绍详情页入口,当前已接入上野正信的人物介绍展示页,可直接用于前端展示和风格参考。

打开介绍详情

前端接入顺序

根页只保留最关键的对接说明,具体字段和示例还是以 HTML 文档页为准。

  • 1
    准备 LINE 授权地址 前端请求 prepare 时只需要带一个 redirect_uri,成功和失败都会回到同一个前端地址。
  • 2
    交换登录态 回调成功后从 URL 拿到 auth_code,再换成 access_tokenrefresh_token
  • 3
    调用业务接口 报名、投票、抽奖都统一走 Authorization: Bearer <access_token>
  • 4
    先绑码后抽奖 用户先绑定抽奖码获取抽奖机会,再调用抽奖接口;抽奖成功会直接扣减当前可用机会数。

常用接口

几个最常用的前台对接入口,复制到前端工程里会更快一些。

GET
https://api.rgun9.top/api/frontend/auth/line/prepare
POST
https://api.rgun9.top/api/frontend/auth/line/exchange
POST
https://api.rgun9.top/api/frontend/activity/signups/submit
POST
https://api.rgun9.top/api/frontend/activity/votes/submit
POST
https://api.rgun9.top/api/frontend/activity/awards/bind-code
POST
https://api.rgun9.top/api/frontend/activity/awards/draw