인증
API 엔드포인트를 사용하려면 먼저 인증해야 합니다. 이 가이드는 Sheetize Cloud 플랫폼에서 인증 자격 증명을 얻고 사용하는 방법을 설명합니다.
주요 기능
Sheetize Cloud의 인증 흐름은 데이터를 보호하고 권한이 있는 사용자만 파일을 업로드하고 서비스를 호출할 수 있도록 설계되었습니다. 제공되는 기능:
- Secure, token-based access that can be revoked at any time.
- Support for both machine-to-machine and user-driven scenarios.
- Granular scopes that let you limit what a token can do.
사용 방법
애플리케이션 만들기
- 다음으로 이동합니다: 대시보드
- 로그인 후 왼쪽 탐색 바에서 **애플리케이션** 메뉴 항목을 클릭합니다.
- **새 애플리케이션 만들기**를 눌러 애플리케이션 생성 양식을 엽니다.
- *애플리케이션 세부 정보* 섹션에 애플리케이션의 설명적인 이름과 짧은 설명을 입력합니다.
- **저장** 버튼을 클릭하여 새 애플리케이션을 저장합니다.
- 애플리케이션 목록에서 방금 만든 애플리케이션을 찾아 이름을 클릭합니다.
- *클라이언트 자격 증명* 패널에 **Client ID**와 **Client Secret**이 표시됩니다. 이 값들을 안전하게 보관하십시오; 액세스 토큰을 얻는 데 필요합니다.
액세스 토큰 받기
-
다음에 요청을 보냅니다: 인증자 엔드포인트
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - 실행 후 토큰을 받게 되며, 이후 사용을 위해 저장해 주세요.
엔드포인트 사용
- 호출하려는 API를 선택하십시오. 이 예시에서는 스프레드시트 파일을 PDF 형식으로 변환하는 Conversion 서비스를 시연합니다.
-
파일과 액세스 토큰을 포함한 요청을 보냅니다. 변환 API
curl -X 'POST' \ 'https://api.sheetize.cloud/conversion/to-pdf' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer The_Secret_Access_Token \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@TestFile.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
서비스는 생성된 PDF에 대한 다운로드 URL을 반환합니다. 이 예시에서는 다음과 같습니다:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
파일 이름과 폴더 이름을 포함한 요청을 다음에 보냅니다: 다운로드 API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - 파일을 받게 되며 이를 사용하거나 워크플로우의 다음 단계로 전달할 수 있습니다.
