CATALOG API · 1.0.0-rc.19

카탈로그 정본을
코드에서 사용하세요Use the canonical catalog
from your code

공개 읽기 API는 별도 API 키 없이 호출할 수 있습니다. 응답의 데이터 모드, 출처와 미확인 값을 보존해 제품 수·가격·품질을 추측하지 마세요.Public read APIs require no separate API key. Preserve the response data mode, provenance, and unknown values; do not infer product counts, pricing, or quality.

검색 가능한 API 제품Searchable API products50,389qualified_unique만 포함qualified_unique only

데이터 릴리스Data release1.0.0-rc.17Stage 24 해시 고정 정본Stage 24 hash-locked release

코드 릴리스Code release1.0.0-rc.19상태·검색·상용정보 hardeningstatus, search, and commercial-data hardening

제품 분자 외 엔터티Non-product entities기여 00 contribution버전·엔드포인트·SDK·MCPversions, endpoints, SDKs, MCP

QUICK START

첫 검색 요청Your first search request

OpenAPI 3.1 명세OpenAPI 3.1 specification

curl "http://127.0.0.1:3000/api/v1/search?q=payment&category=payments-commerce&page=1&limit=10"

q, category, tag, protocol, page, limit, sort를 조합합니다. 번들 모드에서 근거가 없는 인증·가격·공식성 필터는 일치 항목을 꾸며내지 않고 0건을 반환합니다.Combine q, category, tag, protocol, page, limit, and sort. In bundled mode, unsupported authentication, pricing, or official-status filters return zero results instead of inventing matches.

{
  "items": [/* API products only */],
  "total": 151,
  "page": 1,
  "limit": 10,
  "elapsedMs": 0.12,
  "mode": "bundled"
}

mode는 bundled 또는 database입니다. elapsedMs는 서버 내부 검색 시간이며 네트워크 왕복 시간은 포함하지 않습니다.mode is bundled or database. elapsedMs measures server-side search time and excludes network round-trip time.

READ API

공개 조회 엔드포인트Public read endpoints

카탈로그 사실과 운영 준비 상태를 서로 다른 응답으로 제공합니다.Catalog facts and operational readiness are exposed as separate responses.

GET/api/v1/search이름·공급자·분류·태그·프로토콜 검색Search by name, provider, category, tag, and protocol

GET/api/v1/apis/{slug}API 제품 상세와 근거·가격·사용 정보API product detail, evidence, pricing, and usage information

GET/api/v1/catalog-status현재 카탈로그 수치와 데이터 모드Current catalog counts and data mode

GET/api/v1/releases/{version}불변 데이터 릴리스와 검사 결과Immutable data release and verification results

GET/api/v1/scale-status제품/버전/엔드포인트/MCP 집계 경계Product, version, endpoint, and MCP counting boundary

GET/api/v1/launch-readiness프로덕션 전 완료·미완료 게이트Completed and open pre-production gates

GET/api/v1/operations-status공개 운영 사실과 관측 공백Public operational facts and observation gaps

GET/api/v1/resilience-status복원력 검증·미실행 경계Resilience evidence and untested boundaries

GET/api/v1/autopilot-status자동화 가능 범위와 사람 승인 경계Automation scope and human approval boundary

GET/api/v1/catalog-growth고정 소스와 보수적 증가 사실Pinned sources and conservative growth facts

COUNTING CONTRACT

제품 수를 섞지 마세요Do not mix entity counts

API 제품 50,389개만 공개 제품 분자입니다. 버전 24,590건, 엔드포인트 167,917건, MCP 서버 18,644건은 별도 엔터티이며 합산하면 안 됩니다.Only 50,389 API products contribute to the public numerator. 24,590 versions, 167,917 endpoints, and 18,644 MCP servers are separate entities and must not be added.

집계 경계 보기 →View counting boundary →

WRITE API

저장은 운영 DB가 필요합니다Writes require a production database

/api/submissions, /api/rights-requests, /api/provider-claims는 same-origin 요청과 운영 저장소가 필요합니다. DB 미설정 시 가짜 접수 번호 대신 HTTP 503과 PERSISTENCE_UNAVAILABLE을 반환합니다./api/submissions, /api/rights-requests, and /api/provider-claims require same-origin requests and durable storage. Without a configured database they return HTTP 503 and PERSISTENCE_UNAVAILABLE, never a fake receipt.

운영 게이트 보기 →View operational gates →

NULL POLICY

미확인은 0이 아닙니다Unknown is not zero

null인 가격, 결제수단, 사용빈도, 별표와 실측 품질은 미수집·미연결 상태입니다. 무료·무사용·장애 없음으로 해석하지 마세요.A null price, payment method, usage count, star count, or measured quality value means uncollected or disconnected. It does not mean free, unused, or incident-free.

평가 기준 보기 →View methodology →