API 키 준비
고객 서비스의 백엔드는 API 키로 문서 열기 URL을 요청하고, 문서 상태 조회·저장·다운로드 API를 호출합니다. Upload & Edit를 사용하기 전에 API 키를 만드세요. 첫 문서를 업로드해 편집할 때는 스토리지를 연결하지 않아도 됩니다.
API 키 만들기
- Developer Console에 로그인합니다.
- API Keys에서 Create API Key를 선택합니다.
- 키를 사용할 애플리케이션을 알아볼 수 있는 이름을 입력합니다. 필요하면 설명을 추가하고, 만료일을 선택합니다.
- 키를 생성한 뒤 비밀값을 복사해 백엔드의 비밀정보 저장소에 보관합니다. 키의 표시 이름이나 ID를 비밀값 대신 사용하지 마세요.
백엔드가 API를 호출할 때 키가 활성 상태여야 합니다. 해당 키로 만든 문서 세션을 사용하는 동안 같은 키를 유지하세요. 같은 계정에서 만든 다른 키라도 기존 세션에는 접근할 수 없습니다.
브라우저 JavaScript, 모바일 애플리케이션, 소스 코드, 로그나 문서 URL에 비밀값을 넣지 마세요. 고객 서비스는 Office URL을 요청하기 전에 사용자를 인증하고 문서 접근 권한을 확인해야 합니다. API 키는 Developer Console 계정을 식별하며, 고객 서비스 사용자의 신원이나 문서 권한을 대신 확인하지 않습니다.
API 요청 인증
가이드의 $THINKFREE_API_KEY는 백엔드 환경에 보관한 비밀값을 뜻합니다. 백엔드에서 https://api.thinkfree.com의 API를 호출할 때 Authorization 헤더에 다음과 같이 값을 넣습니다.
Authorization: Bearer <YOUR_API_KEY>
사용자의 브라우저가 응답의 browser.openUrl을 열 때는 이 헤더를 보내지 않습니다. 이 URL은 Office 화면을 여는 주소입니다. 별도로 반환되는 api URL은 백엔드에서 호출하는 API 주소이며 API 키가 필요합니다.
다음 단계: 파일 하나 업로드하고 편집하기
Upload & Edit에서 문서를 전송하고 반환된 URL을 여는 방법을 따라 하세요. 지원되는 Office 파일 하나만 있으면 되고, 스토리지는 연결하지 않아도 됩니다. 이 과정을 확인한 뒤 문서를 반복해서 열거나 원래 위치에 저장해야 한다면 고객 서비스의 스토리지를 연결하세요.