공개 API·계약 다운로드

이 서비스의 HTTPS 주소에서 아래 GET 경로로 제공되는 정보를 조회할 수 있습니다.

알 수 없거나 중복된 쿼리는 거부합니다. 페이지는 1–50개(기본50)이며 조건을 유지하고 next_cursor를 사용합니다. 이슈 API 검색은 256문자·UTF-8 1024B, 웹 검색은 200문자·800B입니다. 응답 성공·결과 없음은 프로젝트 안전·전체 수집·피드 발행을 뜻하지 않습니다.

허용 파라미터·상한

• 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를 도움 요청 시 보관하세요. 이 조회는 모델·조치를 실행하지 않습니다.