公开 API 和契约下载

通过本服务 HTTPS 地址下的 GET 端点读取可用信息。

未知或重复查询参数会被拒绝。每页1–50项（默认50），使用 next_cursor 时保持筛选条件。问题 API 搜索上限256字符 / UTF-8 1024B，网页为200 / 800。成功或空响应不代表项目安全、完整采集或 feed 已发布。

允许的参数与上限

• GET /api/v1/public/capabilities

  —

• GET /api/v1/public/issues

  q; confirmation=candidate; source_state=active|corrected|withdrawn|conflicting; modified_after=RFC3339; limit=1…50; cursor

• GET /api/v1/public/issues/{id}

  revision ≥ 1

• GET /api/v1/public/issues/{id}/investigation-prompt

  revision ≥ 1 (required) → JSON

• GET /api/v1/public/issues/{id}/investigation-prompt.txt

  revision ≥ 1 (required) → text/plain; charset=utf-8

• GET /api/v1/public/status

  —

• GET /api/v1/public/status/collection

  limit=1…50; cursor

• GET /api/v1/public/status/notices

  component=query|feed|collection; locale=en|ko|ja|zh-Hans|es|fr|ru|pt-PT; limit=1…50; cursor

• GET /api/v1/public/status/notices/{id}

  revision ≥ 1

• GET /api/v1/public/vendor-news

  q ≤ 200 characters / 800 UTF-8 bytes; vendor=gitlab|railway|vercel|supabase; kind=incident|patch|advisory|outage; deployment=saas|self_hosted|mixed|unknown; product_id; origin_locale=en|ko|ja|zh-Hans|es|fr|ru|pt-PT|und; limit=1…50; cursor

• GET /api/v1/public/vendor-news/{id}

  revision ≥ 1

• GET /api/v1/public/contracts/{version}

  version=current|1.0.0|1.1.0|1.2.0|1.3.0

• GET /api/v1/public/contracts/{version}/{artifact}

  version=current|1.0.0|1.1.0|1.2.0|1.3.0; artifact: public-contracts.openapi.json, issue-page.schema.json, feed-manifest.schema.json, feed-record.schema.json, feed-record-v1.1.schema.json, feed-record-v1.2.schema.json, feed-recovery.schema.json, feed-record-v1.3.schema.json, issue-page-v1.3.schema.json, public-api.openapi.v1.0.0.json

查询示例（相对此 HTTPS 服务）

• GET /api/v1/public/capabilities
• GET /api/v1/public/issues?limit=10
• GET /api/v1/public/status
• GET /api/v1/public/vendor-news?vendor=gitlab&limit=10

错误与恢复

404：不可用、不支持或已停止公开，请返回当前信息。422：修正参数。409：cursor 范围改变，410：cursor 过期，均需重新查询。429：按 Retry-After 等待。503：稍后重试。求助时保留返回的 error.code、request_id。这些读取不会启动模型或修复。