API 文档

本页公开评审平台的只读数据接口，供外部页面、脚本或物实官方拉取作品排名使用。所有接口均为只读，无需鉴权，允许跨域。

一、作品排名接口

GET https://psxt.zzq.skin/api_rank.php

返回评审平台的作品排名数据。评审员身份一律匿名（评审员#编号），与站内对外口径一致。

请求参数

参数	类型	默认	说明
`status`	string	`all`	筛选状态：`all` / `reviewing`（评审中）/ `passed`（已通过）/ `rejected`（未通过）
`limit`	int	`200`	返回条数，范围 1 - 500
`format`	string	`json`	`json` 返回结构化数据；`text` 返回可直接粘贴的排名文本

示例请求

curl "https://psxt.zzq.skin/api_rank.php?status=passed&limit=50"

curl "https://psxt.zzq.skin/api_rank.php?format=text"

响应字段

字段	说明
`generated_at`	本次响应生成时间
`data_updated_at`	数据更新时间（最近一次拉取时间）
`items[].id`	平台内作品 ID
`items[].title`	作品标题
`items[].author`	作者昵称
`items[].subjects`	学科（多学科以「、」分隔）
`items[].status` / `status_text`	状态枚举与中文
`items[].avg_score` / `reviews`	当前均分（无评分为 `null`）与评审人数
`items[].progress` / `suggestion`	当前状态与评审建议
`items[].veto`	是否存在否决票
`items[].final_score` / `closed_at`	最终得分与完结时间（未完结为 `null`）
`items[].plweb_url` / `link_code`	物实帖子链接与链接代码
`items[].platform_url`	本站作品详情页地址

响应示例

{
    "ok": true,
    "generated_at": "2026-10-02 16:28:07",
    "data_updated_at": "2026-10-02 16:27:54",
    "filter": {
        "status": "all",
        "limit": 200
    },
    "count": 1,
    "items": [
        {
            "id": 3369,
            "title": "全金属外壳",
            "author": "Lecourant",
            "subjects": "历史学",
            "status": "reviewing",
            "status_text": "评审中",
            "avg_score": null,
            "reviews": 0,
            "progress": "未评审",
            "suggestion": "不予建议",
            "veto": false,
            "final_score": null,
            "closed_at": null,
            "plweb_url": "https://plweb.turtlesim.com/#/p/Discussion/6abe6aa7b03b100b2a769ba8",
            "link_code": "<discussion=6abe6aa7b03b100b2a769ba8>全金属外壳</discussion>",
            "platform_url": "https://psxt.zzq.skin/work.php?id=3369"
        }
    ]
}

text 格式

每行格式：作品标题-作者-学科-评审人数-评审均分-状态-建议，可直接粘贴到物实状态报告帖。

调用建议

接口只读，可安全轮询；建议间隔不低于 5 分钟，避免给服务器造成压力。
数据随评审实时更新，data_updated_at 反映的是「拉取外部作品」的时间，不等同于评审时间。
如需按学科筛选，请拉取全量后自行按 subjects 字段过滤。

二、物实社区官方 API

本平台的数据来源为物实社区官方 API（https://physics-api-cn.turtlesim.com）。以下为平台实际使用的接口，供需要自行拉取外部作品的开发者参考。

接口	用途	要点
`/Users/Authenticate`	登录（匿名或账号密码）	返回 `AuthCode` / `Token` / `Data.User.ID`；后续请求需在请求头带 `x-API-AuthCode` 与 `x-API-Token`
`/Contents/QueryExperiments`	查询黑洞区「精选申请」作品	固定 `Category=Discussion`、`Tags=["精选申请"]`；实测 `Skip`/`From` 分页参数无效，`Take` 上限 30
`/Messages/SendMessage`	发送站内信（评审任务通知）	需要可登录的物实账号；接收方须填写 24 位物实用户 ID
`/Users/GetUser`	查询用户信息（本平台用于申诉时验证物实身份）	返回昵称等公开信息

请求均为 POST + application/json；官方域名的 TLS 证书与主机名不匹配，客户端需关闭证书校验。

三、链接代码

物实帖子正文支持以下格式的链接代码，本平台作品页提供一键复制：

<discussion=作品ID>标题</discussion>

其中「作品ID」为讨论帖的真实 ID（24 位十六进制），也可通过排名接口的 link_code 字段直接获取。