Compress

Compress 공식 문서에 오신 것을 환영합니다. 이 경량이면서도 강력한 API는 단일하고 직관적인 요청만으로 스프레드시트 파일을 원래 크기의 일부로 축소하도록 설계되었습니다. 데이터 중심의 오늘날, 팀들은 간단한 목록부터 복잡한 재무 모델까지 모든 내용을 담은 스프레드시트를 끊임없이 교환합니다. 이 파일들의 방대한 양은 숨은 비용으로 작용할 수 있는데, 업로드 지연, 저장 비용 증가, 하위 시스템의 처리 시간 연장 등이 그 예입니다. Compress는 이러한 문제점을 해결하기 위해 클라우드 네이티브 서비스를 제공하며, 스프레드시트의 내부 구조를 지능적으로 분석하고 불필요한 요소를 제거한 뒤, 데이터 무결성과 가독성을 손상시키지 않으면서 최적화된 압축 형태로 재패키징합니다. 이 문서 페이지는 하나의 진실된 정보원으로서, 인증부터 요청 형식, 오류 처리 및 배치 처리에 대한 모범 전략까지 API 사용에 필요한 모든 내용을 안내합니다. 여러분이 백엔드 엔지니어이든, 프론트엔드 개발자이든, 혹은 조직 전체의 저장 비용 절감을 담당하는 IT 매니저이든, 이 가이드는 다양한 언어의 코드 스니펫과 실제 예시를 통해 다양한 스프레드시트 포맷에 대한 최적 압축 결과를 얻는 방법을 명확히 제시합니다. 문서 전반에 걸쳐 TLS 암호화, 서명된 JWT 토큰, GDPR 준수 데이터 처리와 같은 보안 고려 사항과 다양한 워크로드에서의 지연 시간 및 처리량을 보여주는 성능 벤치마크를 포함합니다. 또한 일반적인 시나리오를 다루는 FAQ, 신속한 문제 진단을 위한 트러블슈팅 매트릭스, 그리고 커뮤니티 포럼 링크도 제공하여 실전에서 Compress를 활용하는 다른 개발자들과 인사이트를 공유할 수 있습니다. 이 가이드를 마치면 환경을 설정하고 올바른 API 호출을 전송하며 응답 페이로드를 해석하는 데 자신감을 얻어, 기존 워크플로우에 압축 기능을 원활히 통합하고 저장 비용과 네트워크 대역폭 절감 효과를 즉시 확인할 수 있습니다. 역할에 맞는 섹션을 탐색하고 데이터 축소의 무거운 작업을 Compress에 맡겨 더 풍부하고 반응성이 뛰어난 애플리케이션 구축에 집중하세요.

주요 기능

Compress API의 핵심은 스프레드시트 축소를 손쉽고 신뢰성 있게 만드는 풍부한 기능 세트에 있습니다. 우선 서비스는 Apple Numbers, 일반 CSV 및 TSV 파일, Microsoft Excel의 .xlsx 및 .xls 형식 등 다양한 파일 유형을 지원하므로 사전 변환 없이 거의 모든 스프레드시트를 전송할 수 있습니다. 엔진은 다단계 최적화를 수행합니다. 파일 내부 XML 또는 바이너리 구조를 정규화하고, 중복 스타일을 제거하며, 동일한 셀 서식을 병합하고, 데이터가 없는 숨겨진 행·열을 삭제합니다. 또한 이미지, 차트, 피벗 테이블과 같은 임베디드 객체를 각각에 맞는 무손실 압축 알고리즘으로 압축하여 용량을 줄입니다. 또한 API는 파일 크기를 불필요하게 크게 만드는 메타데이터, 주석, 버전 정보를 감지해 제거합니다. 이 모든 작업은 실시간으로 수행되어 50 MB 이하 파일은 밀리초 단위로 결과를 반환하고, 더 큰 문서에도 부드러운 제한 및 진행 콜백을 통해 확장됩니다. 보안도 기본 적용됩니다. 모든 요청은 HTTPS를 통해 전송되며, 서비스는 짧은 처리 시간 외에 파일 복사본을 보관하지 않아 엄격한 개인정보 보호 규정을 준수합니다. 개발자 관점에서 API는 최대한 간편하도록 설계되었습니다. 파일을 multipart/form-data 형태로 `/compress` 엔드포인트에 POST 하면, 새 파일의 다운로드 URL, 원본 및 압축 후 크기, 검증용 체크섬을 포함한 JSON 응답을 받습니다. 선택 매개변수를 통해 압축 수준을 미세 조정하거나 특정 시트를 보존하고, 하위 애플리케이션에서 완전한 연동이 필요할 경우 특정 임베디드 객체를 화이트리스트에 추가할 수 있습니다. Python, Node.js, Java, Go용 포괄적인 SDK가 제공되며, 각각 `compressSpreadsheet(filePath, options)`와 같은 간결한 래퍼 메서드를 제공하여 HTTP 레이어를 완전히 추상화합니다. 세부적인 레이트 제한 문서와 대량 업로드 엔드포인트를 활용하면 인프라에 부담을 주지 않으면서도 시간당 수천 개 파일을 처리할 수 있으며, 내장된 재시도 로직과 지수 백오프 처리로 일시적인 네트워크 오류에도 파이프라인을 견고하게 유지합니다. 요약하면 Compress API는 빠르고 안전하며 개발자 친화적인 솔루션으로, 스프레드시트 저장 용량을 줄이고 파일 전송을 가속화하며 단일 호출만으로 데이터 관리 워크플로우를 단순화합니다.

문서

매개변수

AppRequest.CompressionLevel: 압축 수준 (1에서 9까지)
UploadFileRequest.OperationId: 작업 ID입니다
UploadFileRequest.Files: 온라인 서비스에 업로드해야 하는 파일이며, 데이터를 원하는 방식으로 준비할 수 있지만 HTML 파일 입력 표준을 따라야 합니다.

엔드포인트 사용

파일과 액세스 토큰을 포함한 요청 전송 Compress API

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
서비스는 처리된 파일의 다운로드 URL을 반환합니다. 예시:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
파일 이름과 폴더명을 포함한 요청 전송 Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
파일을 받게 되며, 이를 사용하거나 워크플로우의 다음 단계로 전달할 수 있습니다.