Cloud Office
자체 Office 서버를 운영하지 않고도 문서를 열고 편집하고 저장할 수 있습니다. 파일 하나를 업로드하거나 고객 서비스의 스토리지를 연결한 다음, 반환된 URL을 브라우저에서 열어 Word, Cell 또는 Show를 사용합니다.
Cloud Office는 Thinkfree Cloud에서 Thinkfree가 운영하는 Office 서비스입니다. Self-hosted Office와 달리 사용자가 Office 서버를 직접 운영하지 않습니다. 고객 서비스는 사용자를 인증하고 해당 사용자가 열 수 있는 문서를 확인한 뒤 세션을 요청합니다.
처음 시작하는 순서
- API 키 준비에서 백엔드 인증을 준비합니다.
- Upload & Edit로 파일 하나를 업로드하고 편집합니다. 스토리지 설정 없이 첫 문서를 열 수 있습니다.
- 문서를 원래 저장소에 계속 보관하려면 Bring Your Own Storage로 스토리지를 연결합니다.
- Cloud Office API에서 서비스 연동 절차를 확인하고, API Reference에서 각 요청·응답의 전체 필드를 확인합니다.
워크플로 선택
Upload & Edit
스토리지를 연결하지 않고 파일 하나를 업로드해 편집합니다. 문서를 연 뒤 닫기 전에 API로 저장하거나 다운로드할 수 있습니다.
사용 가능 · 고객 스토리지Bring Your Own Storage
Amazon S3, S3 호환 Object Storage 또는 WebDAV를 연결해 문서를 열고 저장합니다.
Cloud Office API
인증 방법과 API 경로를 확인하고 직접 호출합니다. 각 필드와 오류 코드는 API Reference에서 확인합니다.
요청과 응답Cloud Office API Reference
각 API의 요청 필드, 응답 필드, URL 유효기간과 오류 코드를 확인합니다.
문서 소스 선택
일회성 파일은 스토리지 연결 없이 직접 업로드합니다. Amazon S3, S3 호환 Object Storage 또는 WebDAV에 계속 보관할 문서는 연결을 등록하고 storageId와 documentPath로 식별합니다. 두 방식 모두 클라이언트 세션을 만듭니다. 응답의 browser 그룹에는 Office를 여는 URL이, api 그룹에는 백엔드에서 인증 후 호출할 주소가 포함됩니다. 고객 서비스의 백엔드는 세션을 만든 API 키로 상태를 조회하고, 열린 Editor 문서를 저장하거나 열린 문서를 다운로드할 수 있습니다.
고객 서비스는 세션 요청에 보낼 사용자·문서 ID도 관리합니다. 같은 사용자의 userId와 같은 문서의 docId는 다시 열 때 재사용하고, 다른 사용자와 문서에는 다른 값을 배정합니다. Developers는 세션 생성에 성공할 때마다 새 clientSessionId를 반환합니다. 사례와 선택 필드를 생략했을 때의 동작은 사용자·문서·세션 ID에서 확인하세요.
편집한 문서를 애플리케이션 소유 스토리지에 유지해야 한다면 Bring Your Own Storage를 선택합니다. API 키는 같은 Developer Console 계정이 소유한 연결에만 접근할 수 있으며 스토리지 자격 증명은 공개 API에서 반환되지 않습니다.
Office가 자체 네트워크, Kubernetes 클러스터 또는 규정 준수 경계 내에서 실행되어야 하는 경우 Self-hosted Office를 선택합니다.