Document Management SDK

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

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

호출 전에

모든 endpoint는 직접 운영하는 Thinkfree Drive의 /api/external/v1 아래에 있으며, 관리자가 발급한 API Key로 인증합니다. 다른 페이지는 모두 아래 두 페이지의 내용을 바탕으로 설명하므로 먼저 읽어 보세요.

여기부터

Common conventions

Base URL, 모든 endpoint에 공통으로 적용되는 응답 구조, 페이지네이션, 날짜 형식과 파일·폴더의 리소스 모델을 설명합니다.

여기부터

Authentication

API Key 발급 방법, scope 종류, scope를 검사하는 endpoint, 키의 만료일 변경·재발급·비활성화 방법을 설명합니다.

주요 기능

Files

파일을 업로드·다운로드하고 미리 보며, 이름 변경·이동·복사·삭제와 새 Office 문서 생성을 지원합니다.

Folders

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

Sharing

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

Users

API Key를 발급받은 계정을 기준으로 드라이브, 최근 문서함, 중요 문서함, 휴지통, 알림, 개인 설정을 관리합니다.

Administration

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

Audit logs

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

여러 tenant를 운영한다면 Super Admin으로 전체 tenant를 관리할 수 있습니다. API가 반환하는 오류 코드는 Errors에서 확인할 수 있습니다.

문서 편집 및 거버넌스 연동

Document Management SDK의 문서 관리 기능과 함께 문서 편집이나 문서 활동 기록 기능이 필요하면 다음 SDK와 연동 사례를 참고하세요.

문서 편집이 필요하다면

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

문서 활동을 증적하려면

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