§ Reference · Speaker Intelligence Database · v0.1

Locus API · 学者情报

Locus API 把清北学术演讲生态——讲者、活动、纪要——封装为机构客户可程序化访问的数据接口。本页是 v0.1 阶段的标准端点速查；正式合同与 SLA 详见企业订阅协议。

§ 鉴权

Authentication

所有请求需在 Header 中携带 Bearer Token。Token 由企业订阅签约后由 Locus 编辑团队签发。

# 在每个请求中携带 Token
Authorization: Bearer sk_live_locus_xxx_yyyyyy

§ 1 · 学者档案

GET/v1/speakers/{id}

获取一位学者的完整档案：基本信息、历届出现、媒体痕迹、受众反馈、跨学科扩散度。

参数	类型	说明
id	string · path · 必填	学者 slug，如 krugman、quantum、zhang
include	string · query	visits,media,reception,recommendations

§ 示例 curl

curl https://api.locus.example/v1/speakers/krugman \
  -H "Authorization: Bearer sk_live_locus_xxx"

§ 200 · 示例响应

{
  "id": "krugman",
  "name": "Paul Krugman",
  "affiliation": "Princeton / CCNY",
  "badges": ["Nobel 2008"],
  "visits": [
    { "year": 2019, "venue": "PKU", "score": 4.5 },
    { "year": 2022, "venue": "PKU", "score": 4.7 },
    { "year": 2024, "venue": "THU", "score": 4.6 }
  ],
  "reception": {
    "notes_total": 147,
    "editor_pick_rate": 0.12,
    "cross_discipline_pct": 0.41
  }
}

§ 2 · 当日活动

GET/v1/events

按日期返回当日活动列表。可叠加场地、学院、标签等筛选。

参数	类型	说明
date	string · query · 必填	YYYY-MM-DD，默认当日
venue	string · query	PKU / THU / 双清咖啡等
tag	string · query	economics / quantum / cogsci 等

§ 示例 curl

curl "https://api.locus.example/v1/events?date=2026-05-06" \
  -H "Authorization: Bearer sk_live_locus_xxx"

§ 3 · 某场纪要

GET/v1/notes

按事件返回纪要列表，含作者、信用值、票数、被收藏数。仅返回作者已开启「机构端可见」的纪要。

参数	类型	说明
event_id	string · query · 必填	如 krugman
sort	string · query	votes（默认） / time / editor_pick
limit	int · query	1–100，默认 20

§ 示例 curl

curl "https://api.locus.example/v1/notes?event_id=krugman&sort=votes" \
  -H "Authorization: Bearer sk_live_locus_xxx"

§ 4 · 订阅学者更新

POST/v1/subscribe

订阅一位学者的更新（新场次预告、纪要发布、媒体新动态）。结果通过 webhook 回调指定 URL。

参数	类型	说明
speaker_id	string · body · 必填	如 krugman
events	string[] · body	visit_announced, note_published, media_pickup
callback_url	string · body · 必填	HTTPS · 接收 webhook

§ 示例 curl

curl -X POST https://api.locus.example/v1/subscribe \
  -H "Authorization: Bearer sk_live_locus_xxx" \
  -H "Content-Type: application/json" \
  -d '{"speaker_id":"krugman","events":["visit_announced","note_published"],"callback_url":"https://your.example/hook"}'

§ Pricing · API 访问需企业订阅 · ¥5,000–30,000 / 年

联系 api@locus.example 申请 sandbox token · 正式签约附 SLA 与 webhook 回放保障