Document Management SDK

제품에 문서 관리 기능을 연결하세요

Document Management SDK는 파일과 폴더, 공유와 권한, 사용자와 테넌트 관리, 감사 로그 등 제품에 필요한 문서 관리 기능을 REST API로 제공합니다.

호출 전에

모든 endpoint는 직접 운영하는 Thinkfree Drive 배포의 /api/external/v1 아래에 있으며, 관리자가 발급한 API Key로 인증합니다. 아래 두 페이지를 먼저 읽습니다. 나머지 페이지는 모두 이 내용을 전제합니다.

여기부터

Common conventions

Base URL, 모든 endpoint가 공유하는 응답 구조, 페이지네이션, 날짜 형식, 그리고 파일과 폴더가 함께 쓰는 리소스 모델입니다.

여기부터

Authentication

API Key를 어떻게 발급하는지, scope에 어떤 값이 있는지, 어느 endpoint 그룹이 scope를 검사하는지, 키를 만료·재발급·비활성화하는 방법입니다.

무엇을 할 수 있는지

Files

파일을 올리고 내려받고 미리 보고, 이름 변경·이동·복사·삭제하며, 새 Office 문서를 만듭니다.

Folders

폴더 트리를 만들고 정리하며, 내용을 조회하고, 자주 쓰는 폴더를 고정합니다.

Sharing

지정한 사용자, tenant 전체, 또는 공개 링크로 리소스를 공유하고 권한을 각각 제어합니다.

Users

한 계정의 입장에서 동작합니다. 드라이브, 최근 항목과 중요 항목, 휴지통, 알림, 개인 설정입니다.

Administration

한 tenant의 계정·용량·라이선스를 관리하고 로그인, 브랜딩, 접근 제한, 공유, SMTP를 설정합니다.

Audit logs

tenant의 감사 기록을 페이지 단위로 조회하거나, 지정한 기간을 CSV로 내보내 Drive 밖에서 검토합니다.

여러 tenant를 함께 운영하는 배포에는 tenant를 넘나드는 동작을 위한 Super Admin이 있습니다. API가 반환하는 실패 코드는 Errors에 모두 모여 있습니다.

문서 편집 및 거버넌스 연동

Document Management SDK의 문서 관리 기능과 함께 문서 편집 또는 활동 증적 기능이 필요한 경우 다음 SDK와 연동 사례를 참고하세요.

문서 편집이 필요하다면

Document Management SDK는 저장된 문서와 파일·폴더 등의 리소스를 관리합니다. 문서를 열고 편집 화면을 제어하거나 편집 기능을 제품에 연결하려면 Document Editor SDK를 참고하세요.

문서 활동을 증적하려면

Document Management SDK의 Audit Logs를 통해 파일·사용자·관리 활동을 조회할 수 있습니다. 사람과 AI의 문서 변경, 검토와 승인·거절 과정까지 추적하려면 Governance Integration에서 Storage 및 Editor 연동 사례를 확인하세요.