Публичный API и скачивание контрактов

Используйте указанные GET-адреса на HTTPS-адресе сервиса для чтения доступной информации.

Неизвестные и повторные параметры отклоняются. Страница 1–50 записей (по умолчанию 50); используйте next_cursor без изменения фильтров. Поиск API проблем: 256 символов / 1024 байта UTF-8; веб: 200 / 800. Успех или пустой ответ не подтверждает безопасность, полноту сбора или публикацию потока.

Параметры и ограничения

• 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: изменилась область курсора; 410: истёк; начните заново. 429: ждите Retry-After. 503: повторите позже. Сохраните error.code и request_id, если они есть. Чтение не запускает модель или исправления.