REST API
Strata는 OpenAPI 3.1 사양으로 기술된 REST API를 기반으로 구축되어 있습니다. 대부분의 연동은 REST를 직접 호출하는 대신 MCP 서버를 사용하지만, 툴링 및 커스텀 클라이언트를 위한 전체 사양도 제공합니다.
OpenAPI 사양
기계가 읽을 수 있는 사양은 라이브로 제공되며 배포된 API와 항상 동기화됩니다. 직접 열거나 Scalar, Redoc, Postman, Insomnia 같은 뷰어에 임포트하세요:
openapi.json 열기사양은 에이전트 및 크롤러를 위해 /.well-known/api-catalog를 통해서도 공개됩니다.
기본 URL 및 버전 관리
모든 엔드포인트는 API 호스트의 /api/v1 아래에 있습니다. 경로 접두사가 버전을 나타냅니다.
인증
요청에는 베어러 토큰을 포함합니다. 브라우저 세션은 HttpOnly 리프레시 쿠키에서 발급된 단기 액세스 토큰을 사용하고, 프로그래밍 방식의 MCP 액세스는 OAuth 2.1을 사용하며 토큰 발급과 갱신을 자동으로 처리합니다.
리소스 영역
이 API는 Strata 도메인 전체를 다룹니다. 주요 리소스 영역:
- 문서: CRUD, 기록, 댓글, 제안, 접근, 게시, 이미지
- Spaces: 멤버십, 소스, 접근 권한, 하이브리드 검색
- 회사, 조직 및 티어: 워크스페이스 계층 구조
- 사용자 및 프로필: 계정, 멤버십, 공개 프로필
- 접근 및 공유: 권한, 공개 링크, 스페이스 권한 부여
- 인증 및 OAuth: 세션, 테넌트 전환, MCP OAuth 클라이언트
- 에이전트 및 태스크: 플랫폼 및 사용자 에이전트 호출
- 관리 및 컴플라이언스: SSO, SCIM, 감사, 보존, 청구
클라이언트 생성
원하는 언어로 타입이 있는 클라이언트를 생성하려면, OpenAPI 3.1 코드 생성기를 위의 사양에 지정하세요.
직접 REST보다 도구를 선호하시나요? MCP 도구 참고를 확인하세요.