开放接口

按关键词搜索群组。调用需要 API Key，申请后由站方审核。

获取 API Key

登录后在后台的 API Key 页面填写用途提交申请。通过后在同一页面生成 Key。Key 只显示一次，请立即保存；重新生成会让旧 Key 失效。

搜索群组

GET /api/v1/open/groups?content=<关键词>&type=<SCHOOL|REGION>，与站内搜索是同一套逻辑：content 至少 2 个字，type 可省略（省略时搜索所有类型，只要院校群请传 type=SCHOOL）；地区联合群传 type=REGION 会按覆盖范围分层返回，另加 mode=keyword 可强制走关键词模式。用请求头 Authorization: Bearer <Key> 或 x-api-key: <Key> 传 Key。

curl -H "Authorization: Bearer <你的 API Key>" \
  "https://www.linktofur.net/api/v1/open/groups?content=广东&type=SCHOOL"

返回结构与站内搜索一致，results 是 JSON 数组。区别是每条结果的id 换成了可以直接打开的群组页面地址 url：院校群字段为 url / schoolOrRegionName / name / region / scale，地区联合群为 url / name / subtitle / scale；type=REGION 时另有 mode / coverage 字段。

{
  "total": 2,
  "mode": "keyword",
  "results": [
    {
      "url": "https://www.linktofur.net/group/85",
      "schoolOrRegionName": "广东工业大学",
      "name": "...",
      "region": "广州",
      "scale": "中型组织"
    }
  ]
}

变更说明（旧接口已下线）

开放接口已迁移到带版本号的新地址，旧地址 /api/open/search 已下线（返回 404），没有保留兼容别名。请按下表迁移：

地址：GET /api/open/search → GET /api/v1/open/groups，查询参数与鉴权方式不变。
成功响应：不再包一层 {"code": 200, "message": ...}，直接返回结果对象；total 是数字，results 是真正的 JSON 数组（以前是字符串）。
错误响应：统一为 {"code", "message"}，HTTP 状态码与 code 一致。

限制与错误

每个 Key 有每秒请求数上限，由审核时核定。超出返回 429，并带 Retry-After 响应头，请按它等待后重试。
401：缺少或无效的 Key。403：Key 未启用。
400：content 少于 2 个字或超过 64 个字。
错误回应统一为 {"code": <HTTP 状态码>, "message": "..."}。