公开 API 和契约下载
文档 / 契约包版本: 1.3.0 · API 1.0
通过本服务 HTTPS 地址下的 GET 端点读取可用信息。
未知或重复查询参数会被拒绝。每页1–50项(默认50),使用 next_cursor 时保持筛选条件。问题 API 搜索上限256字符 / UTF-8 1024B,网页为200 / 800。成功或空响应不代表项目安全、完整采集或 feed 已发布。
允许的参数与上限
GET /api/v1/public/capabilities—GET /api/v1/public/issuesq; confirmation=candidate; source_state=active|corrected|withdrawn|conflicting; modified_after=RFC3339; limit=1…50; cursorGET /api/v1/public/issues/{id}revision ≥ 1GET /api/v1/public/issues/{id}/investigation-promptrevision ≥ 1 (required) → JSONGET /api/v1/public/issues/{id}/investigation-prompt.txtrevision ≥ 1 (required) → text/plain; charset=utf-8GET /api/v1/public/status—GET /api/v1/public/status/collectionlimit=1…50; cursorGET /api/v1/public/status/noticescomponent=query|feed|collection; locale=en|ko|ja|zh-Hans|es|fr|ru|pt-PT; limit=1…50; cursorGET /api/v1/public/status/notices/{id}revision ≥ 1GET /api/v1/public/vendor-newsq ≤ 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; cursorGET /api/v1/public/vendor-news/{id}revision ≥ 1GET /api/v1/public/contracts/{version}version=current|1.0.0|1.1.0|1.2.0|1.3.0GET /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, feed-record-v1.4.schema.json, issue-page-v1.4.schema.json, public-api.openapi.v1.1.0.json
查询示例(相对此 HTTPS 服务)
GET /api/v1/public/capabilitiesGET /api/v1/public/issues?limit=10GET /api/v1/public/statusGET /api/v1/public/vendor-news?vendor=gitlab&limit=10
错误与恢复
404:不可用、不支持或已停止公开,请返回当前信息。422:修正参数。409:cursor 范围改变,410:cursor 过期,均需重新查询。429:按 Retry-After 等待。503:稍后重试。求助时保留返回的 error.code、request_id。这些读取不会启动模型或修复。
下载契约原始文件
当前包为 1.3.0,仍提供不可变的 1.0.0、1.1.0 和 1.2.0。新增带公告类型的 feed record / issue page 1.4 及公开 API OpenAPI 1.1.0。包版本、读取 API 1.0 与 feed record 1.0 / 1.1 / 1.2 / 1.3 / 1.4 各自独立。请固定包版本,解析前核对 SHA-256;schema 检查本身不验证签名、新鲜度或回滚防护。
公开 API 端点请参阅 public-api.openapi.v1.0.0.json。请为响应选择对应的 schema 和版本。feed schema 描述订阅源数据,并非 HTTP 问题列表。
下载固定版本目录 · 1.3.0public-contracts.openapi.json
- 文档 / 契约包版本
- 1.3.0
- SHA-256
36ba19502d350ccdc99d44ceab5406be3f42f12f93cc5b480c929478fda7417e- UTF-8 bytes
- 8401
- Schema ID
urn:si:public-contract-downloads:1.3.0
issue-page.schema.json
- 文档 / 契约包版本
- 1.0
- SHA-256
f66e753ac0d795b4e9fb15e87be6bc7e102dba75309a27bd54dfbd628dd76135- UTF-8 bytes
- 5467
- Schema ID
urn:si:issue-page:1.0
feed-manifest.schema.json
- 文档 / 契约包版本
- 1.0
- SHA-256
931c10b40728820feef73d8afd4c2b9bacefdc1bad890d2d04bc3693b3e186d6- UTF-8 bytes
- 3658
- Schema ID
https://security-intelligence.invalid/contracts/feed-manifest/1.0
feed-record.schema.json
- 文档 / 契约包版本
- 1.0
- SHA-256
b005175eb305d5faf7191ccc96d57a96ef523e3076d8f860ec37e676910542b1- UTF-8 bytes
- 4350
- Schema ID
https://security-intelligence.invalid/contracts/feed-record/1.0urn:si:feed-record:1.0
feed-record-v1.1.schema.json
- 文档 / 契约包版本
- 1.1
- SHA-256
608faebb3521b52a00e06440f547a327ea16469652912371504cef70e0230709- UTF-8 bytes
- 13630
- Schema ID
urn:si:feed-record:1.1
feed-record-v1.2.schema.json
- 文档 / 契约包版本
- 1.2
- SHA-256
917bae2b55717c84530b875bad771a500c5030ca8d5d4e23df26146d47e78733- UTF-8 bytes
- 16801
- Schema ID
urn:si:feed-record:1.2
feed-recovery.schema.json
- 文档 / 契约包版本
- 1.0
- SHA-256
12e6ef875a04eb42e3852a5b480888d46537dfa529757bafcb81ef5ee6f9569e- UTF-8 bytes
- 4935
- Schema ID
urn:si:feed-recovery:1.0
feed-record-v1.3.schema.json
- 文档 / 契约包版本
- 1.3
- SHA-256
43c7d19b82f97bfc4603b482d9db8acba79be2438a2614af9422cf26db8270ce- UTF-8 bytes
- 16804
- Schema ID
urn:si:feed-record:1.3
issue-page-v1.3.schema.json
- 文档 / 契约包版本
- 1.3
- SHA-256
1cbc1b456c0ed65c43d44b3e5a7c99c2d2a7a0a63070e5052a2f15c647e7b188- UTF-8 bytes
- 5675
- Schema ID
urn:si:issue-page:1.3
public-api.openapi.v1.0.0.json
- 文档 / 契约包版本
- 1.0.0
- SHA-256
d3d0a3c859b46d88b9163c2c1b52f4eb6b9072603db6c2583d1cfb93472c74a3- UTF-8 bytes
- 261700
- Schema ID
urn:si:public-api:1.0.0
feed-record-v1.4.schema.json
- 文档 / 契约包版本
- 1.4
- SHA-256
8b2c92c0211439b319a81c88e5f4d1647add5e3d13b10c5f9c6959acde843aa5- UTF-8 bytes
- 16999
- Schema ID
urn:si:feed-record:1.4
issue-page-v1.4.schema.json
- 文档 / 契约包版本
- 1.4
- SHA-256
96edf09f6f5c085029914408a12cd8860b19c3a21a996dae9d9435b0fd82ec38- UTF-8 bytes
- 5883
- Schema ID
urn:si:issue-page:1.4
public-api.openapi.v1.1.0.json
- 文档 / 契约包版本
- 1.1.0
- SHA-256
d5bfd2b566d7be5e89591ade32a8a74464f79f9b0612ede378c844057147af53- UTF-8 bytes
- 262420
- Schema ID
urn:si:public-api:1.1.0