본문으로 건너뛰기
Sursa Developers

API 레퍼런스

공개 Sursa API예요. 35개 섹션에 엔드포인트 222개가 있어요. 버전 1.62.0.

API 키로 인증하는 연동 시스템을 위한 Sursa 공개 API예요. /v1 안의 변경은 추가만 하는 변경이에요. 새 오퍼레이션, 선택 파라미터, 응답 필드, 응답의 열거형 값이 추가될 수 있으며 기존 클라이언트는 계속 동작해요. 응답에서 모르는 열거형 값을 받아도 유효한 값으로 처리하세요.

기본 URL
https://api.sursa.com
인증
Authorization 헤더로 API 키를 보내세요: Authorization: Bearer <키>.

섹션

health엔드포인트 1개

서비스 상태와 버전

auth엔드포인트 1개

로그인, 세션, “View as” 모드(다른 사용자로 보기), 비밀번호 변경과 재설정, 초대 수락

users엔드포인트 5개

조직의 사용자 계정

api-keys엔드포인트 9개

조직의 API 키

apps엔드포인트 8개

조직의 OAuth 앱과 직원 인가

oauth엔드포인트 3개

OAuth 2.0 프로토콜: 동의 화면, 토큰 발급과 폐기, 인가 서버 메타데이터

audit엔드포인트 4개

조직의 감사 로그

org엔드포인트 1개

조직, 조직 로고, 데이터 내보내기

categories엔드포인트 4개

문서 카테고리

collections엔드포인트 6개

지식 컬렉션

cards엔드포인트 26개

지식 카드: 업로드, 내용, 표, 버전, 검증, 댓글

jobs엔드포인트 5개

인덱싱 대기열: 작업, 파싱 미리 보기, 변경 스트림(SSE)

conversations엔드포인트 2개

어시스턴트와의 대화

answers엔드포인트 3개

검색과 어시스턴트 답변(SSE 스트림 포함)

access-requests엔드포인트 4개

숨겨진 답변의 출처에 대한 접근 요청

questions엔드포인트 10개

질문 기록, 제안, 답변 내보내기, 실시간 답변

files엔드포인트 8개

내보내기 파일

insights엔드포인트 1개

인사이트: 요약, 중복, 지식 빈틈, 지식 상태

tasks엔드포인트 1개

사용자와 팀의 할 일

sources엔드포인트 19개

Google Drive, Confluence 같은 데이터 소스

permissions엔드포인트 17개

접근 모델: 권한 레지스트리, 그리고 조직, 컬렉션, 카드, 소스에 대한 권한(직접 부여와 상속 모두)

roles엔드포인트 4개

역할: 이름이 붙은 권한 묶음(기본 제공 역할과 사용자 지정 역할)

groups엔드포인트 7개

사용자 그룹: 일반 그룹, “All members”(전체 멤버), 역할 그룹, 개인 그룹

folders엔드포인트 7개

컬렉션 폴더: 최대 세 단계 깊이의 트리, 같은 수준의 항목을 기준으로 한 순서, 여러 폴더에 들어가는 카드, 상속된 권한

catalog엔드포인트 6개

외부 서비스(SaaS와 공급업체) 카탈로그: 이름, 웹사이트, 카테고리, 아이콘, 설명, 그리고 조직에서 쓰는 이름과 카탈로그 항목의 연결

drafts엔드포인트 6개

초안과 게시 승인

verification엔드포인트 9개

검증: 상태, 기한, 검증자, 이력, “Verify first” 대기열(먼저 검증할 카드), 신뢰도 점수(Trust Score), 오프보딩

announcements엔드포인트 5개

필독 공지: 대상, 읽음 확인, 보고서, 리마인더, 내보내기

comments엔드포인트 4개

앵커와 상태가 있는 카드 댓글 스레드와 반응

webhooks엔드포인트 17개

조직의 웹훅: 웹훅 등록, 이벤트 구독, 서명, 전송과 재시도

public-api엔드포인트 1개

연동 시스템을 위한 공개 API: 이 API의 기계 판독 가능한 명세

uploads엔드포인트 5개

큰 파일의 멀티파트 업로드: 세션, 파트, 검사를 거치는 업로드 완료, 카드·압축 파일·가져오기에서의 사용

analytics엔드포인트 4개

제품 분석: 사용 이벤트, 객체별 카운터, 대시보드(지식 상태, 사용량, 기여), 갱신 보고서, 내보내기

quality엔드포인트 3개

답변 품질: 좋은 답변을 받지 못한 질문과 처리 중인 지식 빈틈

finance엔드포인트 6개

재무 문서: 환율과 거래처 목록

객체