개발자 플랫폼

FabHub 개발자 문서는 API, SDK, MCP 도구, 웹훅, 인증 및 계약 참조 자료에 대한 공식적인 공개 진입점입니다. 여기에 있는 모든 내용은 https://api.fabhub.app/v1에서 제공되는 공개 표면을 설명합니다.

제공되는 기능

이 포털은 docs/developer-platform/docs-source-registry.json에 등록된 공개 안전 개발자 플랫폼 소스로부터 생성됩니다:

제공되는 기능

OpenAPI로 기술된 https://api.fabhub.app/v1의 공개 REST API.

타입이 지정된 서버 측 통합을 위한 공식 TypeScript SDK(@fabhub/sdk).

도구가 공개 API 스코프와 일대일로 매핑되는 큐레이션된 MCP 서버(@fabhub/mcp).

생성된 AsyncAPI 이벤트 계약을 갖춘 서명된 아웃바운드 웹훅.

테넌트 소유 자동화를 위한 API 키 및 승인된 파트너 애플리케이션을 위한 OAuth.

규칙

기본 URL: https://api.fabhub.app/v1. 이 참조의 모든 경로는 이 URL을 기준으로 한 상대 경로입니다.

형식: 요청 및 응답 본문은 JSON이며, 요청 본문은 camelCase 키를 사용합니다.

쿼리 매개변수는 snake_case를 사용합니다(예: page_size, contact_types).

ID는 UUID 문자열입니다. 타임스탬프는 UTC 기준 ISO 8601 형식입니다(예: 2026-06-20T09:30:00Z).

인증: X-API-Key 헤더(또는 Authorization: Bearer)에 API 키를 전송합니다. 인증을 참조하세요.

금액 필드(salePrice, purchasePrice)는 테넌트의 기준 통화로 표시된 숫자이거나 null입니다.

핵심 개념

테넌트: 모든 자격 증명은 하나의 테넌트(조직)에 속하며, 모든 데이터는 테넌트 범위로 한정됩니다.

스코프: 키는 items:read 또는 webhooks:write와 같은 최소 권한 스코프를 갖습니다.

멱등성: 쓰기 요청은 Idempotency-Key를 받아 재시도가 안전합니다. 멱등성을 참조하세요.

페이지네이션: 목록은 페이지 기반이며, 감사 내보내기는 커서 기반입니다. 페이지네이션을 참조하세요.

오류: 기계가 읽을 수 있는 code가 포함된 안정적인 JSON 봉투입니다. 오류를 참조하세요.

공개 안전 소스 문서

이 포털은 docs/developer-platform/docs-source-registry.json에 등록된 공개 안전 개발자 플랫폼 소스로부터 생성됩니다:

docs/developer-platform/api-changelog.md

docs/developer-platform/enterprise-controls.md

docs/developer-platform/hosted-mcp.md

docs/developer-platform/openapi-breaking-change-policy.md

docs/developer-platform/scope-taxonomy.md

docs/developer-platform/usage-endpoint.md

docs/developer-platform/webhook-events.md

docs/developer-platform/versioning-and-deprecation.md