API pública e contratos para descarregar

Utilize os pontos GET abaixo no endereço HTTPS deste serviço para consultar a informação disponível.

Parâmetros desconhecidos ou repetidos são rejeitados. Páginas de 1–50 (50 por omissão); utilize next_cursor sem mudar filtros. Pesquisa API: 256 caracteres / 1024 bytes UTF-8; web: 200 / 800. Uma resposta com êxito ou vazia não prova segurança, recolha completa ou publicação do feed.

Parâmetros e limites

• 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

Exemplos de pedidos (este serviço 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

Erros e recuperação

404: indisponível, não suportado ou já não público; volte à informação atual. 422: corrija parâmetros. 409: âmbito do cursor alterado; 410: expirado; recomece. 429: respeite Retry-After. 503: tente mais tarde. Guarde error.code e request_id, quando fornecidos. As leituras não iniciam modelos nem correções.