Skip to content

Games API

/start

  • 用途:开启比赛
  • 认证:普通用户,比赛中
  • 输入参数:无
  • 输出参数
    参数名类型说明
    statusint状态码
    start_prefixstring谜题前端路径
    is_firstint是否为首次启动

/play/get-article

  • 用途:获取题目文章
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    keystring文章关键字
  • 输出参数
    参数名类型说明
    statusint状态码
    titlestring标题
    contentstring内容
    dataobject附加数据

/play/get-main-info

  • 用途:获取比赛基本信息和题目结构
  • 认证:队员,比赛中
  • 输入参数:无
  • 输出参数
    参数名类型说明
    statusint状态码
    powerpoint_namestring“信用点”的自定义名称
    stageint阶段(自定义值,用于前端展示不同的界面 0-初始状态 1-新手区已通过 2-Final已开启)
    nav_itemsNavbarItem[]导航栏1
    nav_items2NavbarItem[]导航栏2
    puzzle_basic_infoPuzzleBasicInfo[]基本题目结构
    library_idsstring[]已解锁剧情ID
    show_analysisint是否允许显示解析(0-不显示 1-显示)
    • NavbarItem 结构
      参数名类型说明
      titlestring标题
      pathstring路径
    • PuzzleBasicInfo 结构
      参数名类型说明
      pgidint分区ID
      titlestring分区名称
      is_unlockedint0-未解锁 1-已解锁
      is_finishedint0-未完成 1-已完成
      difficultyint难度
      stageint阶段(自定义值,用于标记不同的分区属于哪个阶段 0-新手区 1-正篇 2-Final阶段)

/play/get-puzzle-info

  • 用途:获取指定分区的小题列表
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pgidint分区ID
  • 输出参数
    参数名类型说明
    statusint状态码
    titlestring分区标题
    contentstring分区简介
    detail_basic_infoDetailBasicInfo[]题目列表
    • DetailBasicInfo 结构
      参数名类型说明
      pidint题目ID
      titlestring标题
      puzzle_typeint题目等级(0-小题 1-分区Meta 2-MM 3-FM)
      is_finishedint题目是否完成
      answerstring答案
      is_unlockedint是否已经解锁
      extend_datastring附加数据

/play/get-detail

  • 用途:获取题目内容
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
  • 输出参数
    参数名类型说明
    statusint状态码
    puzzlePuzzleView题目内容
    is_finishint是否完成
    attempts_countint错误尝试次数
    attempts_totalint允许尝试总次数
    power_pointint信用点
    power_point_calc_timeint64信用点值创建时的时间戳
    power_point_increase_rateint信用点增长速率(每分钟)
    • DetailBasicInfo 结构
      参数名类型说明
      pidint题目ID
      pgidint题目分区ID
      typeint题目类型(0-图片 1-HTML 2-VUE 3-上传题目模块)
      titlestring标题
      contentstring内容(通常是flavor text)
      imagestring图片URL
      htmlstring题目内容HTML
      scriptstring题目内容的脚本
      answer_typeint题目等级(0-小题 1-分区Meta 2-MM 3-FM)
      extend_contentstring附加内容(完成后解锁的内容)
      addaint题目是否有中间答案(里程碑) 0-没有 1-有

/play/get-answer-log

  • 用途:获取答案提交记录
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
  • 输出参数
    参数名类型说明
    statusint状态码
    answer_logAnswerLog[]提交记录
    • AnswerLog 结构
      参数名类型说明
      idint提交记录ID
      create_timeint64提交时间(时间戳)
      uidint提交用户ID
      user_namestring用户名
      gidint组ID
      pidint题目ID
      answerstring用户输入的答案
      statusint答案状态(1-正确 2-答案错误 3-答题次数用尽 4-里程碑)
      messagestring附加消息

/play/get-tips

  • 用途:获取提示列表
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
  • 输出参数
    参数名类型说明
    statusint状态码
    is_tip_availableint提示是否可用
    tip_available_timeint64提示开放时间(时间戳)
    tip_available_progressnumber提示开放进度(百分比)
    oracle_unlock_delayint人工提示延迟时间
    oracle_unlock_costint人工提示消耗信用点
    add_attempts_count_costint增加答题次数消耗信用点
    puzzle_tipsPuzzleTips[]提示列表
    oraclesOracleItem[]人工提示列表
    • PuzzleTips 结构
      参数名类型说明
      tips_idint提示ID
      tip_numint提示序号
      is_openint是否已解锁
      contentstring提示内容
      is_avaliableint是否可用
      tip_available_timeint64提示开放时间(时间戳)
      tip_available_progressnumber提示开放进度(百分比)
      unlock_costint解锁提示消耗信用点
    • OracleItem 结构
      参数名类型说明
      oracle_idint人工提示ID
      is_replyint是否已回复
      unlock_timeint64最早解锁时间(时间戳)

/play/unlock-tips

  • 用途:解锁提示
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
    tip_numint提示序号
  • 输出参数
    参数名类型说明
    statusint状态码

/play/add-oracle

  • 用途:启动一个人工提示请求
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
  • 输出参数
    参数名类型说明
    statusint状态码

/play/open-oracle

  • 用途:开封人工提示,阅读回复内容(出题组回复后就像是一个信封,开封时会展示内容,同时也会解锁一些预设提示)
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    oracle_idint人工提示ID
  • 输出参数
    参数名类型说明
    statusint状态码
    dataOracleItem人工提示内容
    • OracleItem 结构
      参数名类型说明
      oracle_idint人工提示ID
      gidint提问队伍ID
      pidint提问题目ID
      question_contentstring提问内容
      update_timeint64提问内容最后编辑时间(时间戳)
      create_timeint64人工提示创建时间(时间戳)
      is_replyint是否已回复
      reply_timeint64回复时间(时间戳)
      reply_contentstring回复内容
      extend_functionstring扩展功能(自动开放预设提示的提示序号,以逗号隔开)

/play/edit-oracle

  • 用途:编辑人工提示提问内容
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    oracle_idint人工提示ID
    question_contentstring提问内容
  • 输出参数
    参数名类型说明
    statusint状态码
    dataOracleItem人工提示内容
    • OracleItem 结构
      参数名类型说明
      oracle_idint人工提示ID
      gidint提问队伍ID
      pidint提问题目ID
      question_contentstring提问内容
      update_timeint64提问内容最后编辑时间(时间戳)
      create_timeint64人工提示创建时间(时间戳)
      is_replyint是否已回复
      reply_timeint64回复时间(时间戳)
      reply_contentstring回复内容
      extend_functionstring扩展功能(自动开放预设提示的提示序号,以逗号隔开)

/play/add-attempts-count

  • 用途:增加答案尝试次数
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
  • 输出参数
    参数名类型说明
    statusint状态码

/play/get-puzzle-board

  • 用途:显示解题状态面板
  • 认证:队员,比赛中
  • 输入参数:无
  • 输出参数
    参数名类型说明
    statusint状态码
    cache_timeint64缓存生成时间(时间戳)
    dataPuzzleStat[]解题状态信息
    • PuzzleStat 结构
      参数名类型说明
      pidint题目ID
      pgidint题目分区ID
      titlestring题目名称
      unlock_countint解锁队伍数
      finish_countint通过队伍数
      last_answer_person_namestring最后通过的用户名

/play/get-library

  • 用途:获取剧情文章数据
  • 认证:队员,比赛中
  • 输入参数:无
  • 输出参数
    参数名类型说明
    statusint状态码
    dataStoryItem[]剧情文章
    • StoryItem 结构
      参数名类型说明
      keystring关键字
      titlestring标题

/play/get-puzzle-analysis

  • 用途:获取解析内容
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
  • 输出参数
    参数名类型说明
    statusint状态码
    analysisstring解析内容

/check-answer

  • 用途:提交答案,判题
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    pidint题目ID
    answerstring答案
  • 输出参数
    参数名类型说明
    statusint状态码
    messagestring附加信息
    answer_statusint判题结果(1-正确 2-答案错误 3-答题次数用尽 4-里程碑)
    extend_flagint0-什么都不做 1-跳转到指定路径(指定路径存入location中) 16-重新载入页面
    locationstring仅在Final Meta通过时,extend_flag会返回1,此时应自动跳转到此地址

/play/call-puzzle-backend

  • 用途:执行后端题目脚本
  • 认证:队员,比赛中
  • 输入参数
    参数名类型说明
    keystring脚本关键字
    datastring前端发送的数据(JSON)
    storesstring系统状态存储
    noncestring系统状态加密随机串
  • 输出参数
    参数名类型说明
    statusint状态码
    datastring返回给前端的数据(JSON)
    storesstring新的系统状态存储
    noncestring系统状态加密随机串

Released under the MIT License. Powered by VitePress.