비교

Comparison API의 공식 문서 허브에 오신 것을 환영합니다. 이 API는 스프레드시트 버전 관리라는 흔히 번거로운 작업을 개발자 중심의 간소화된 워크플로우로 전환하도록 설계되었습니다. 분기별 보고서를 조정하는 데이터 분석가이든, 예산 수정 사항을 추적하는 재무 팀이든, 더 큰 데이터 파이프라인에 diff 기능을 삽입하는 소프트웨어 엔지니어이든, 이 API는 여러분이 있는 곳에서 시작하여 다양한 스프레드시트 형식 전반에 걸쳐 변경 사항을 쉽게 포착하도록 도와줍니다. 핵심 모델은 간단하면서도 강력합니다: 두 개의 소스 파일(Apple Numbers, CSV/TSV 내보내기, 혹은 흔히 사용되는 Excel(.xlsx, .xls) 등)을 제공하면, 서비스는 모든 추가, 삭제, 수정 사항을 명확한 시각적 표시와 함께 단일 결과 파일로 반환합니다. 명확성에 대한 강조는 사후 처리가 아니라 기본이며, 각 차이는 네이티브 스프레드시트 관습(색상 셀 배경, 주석 풍선, 행/열 표시)을 모방한 형태로 주석이 달려 있어 사용자는 결과 파일을 선호하는 애플리케이션에서 열어 바로 변경점을 이해할 수 있습니다. 기본 diff 외에도 API는 원본 서식, 수식, 데이터 타입을 보존하여 출력이 단순 텍스트 보고서가 아니라 추가 분석이나 배포를 위한 완전한 워크북이 되도록 합니다. 보안 및 성능은 모든 요청에 내장되어 있습니다: 모든 파일 전송은 TLS 1.3을 통해 이루어지며, 파일은 메모리 제한이 엄격한 격리된 컨테이너에서 처리되고, 10 MB 이하 파일은 보통 1초 미만에 결과가 반환됩니다. 더 큰 데이터 세트는 청크 스트리밍을 통해 원활히 확장됩니다. 현재 읽고 있는 문서는 몇 분 만에 시작할 수 있도록 구성되었습니다—인증부터 요청 구성, 오류 처리, 페이징, 웹훅 통합에 이르는 모범 사례까지. 각 섹션에는 Python, JavaScript, Java, C# 코드 스니펫이 포함되어 있어 단 한 줄의 코드로 전체 비교를 트리거하는 방법을 보여주며, 브라우저를 떠나지 않고 실제 파일로 실험할 수 있는 샌드박스 환경도 제공합니다. 이 가이드를 마치면 워크플로우 어디에든 신뢰할 수 있는 고품질 스프레드시트 비교를 삽입하고, 수동 검토 시간을 줄이며, 이해관계자에게 투명하고 감사 가능한 변경 로그를 제공할 수 있게 됩니다— 보안과 빠른 속도, 사용 편의성을 겸비한 API를 활용하는 것이죠.

주요 기능

Comparison API는 다양한 플랫폼에서 스프레드시트 데이터를 조정할 때 가장 일반적인 문제점을 해결하는 방대한 기능 세트를 자랑합니다. 무엇보다도 API는 Apple Numbers(.numbers), 일반 텍스트 구분 파일(CSV, TSV), 레거시 Excel(.xls), 최신 Excel(.xlsx) 등 포괄적인 파일 형식 목록을 지원합니다. 이를 통해 사전 변환 도구가 필요 없으며 원본 파일을 직접 서비스에 제공할 수 있습니다. diff 엔진은 셀 수준에서 작동하여 값, 수식, 폰트 스타일, 셀 쉐이딩, 데이터 검증 규칙 등 서식 속성까지 변화를 감지하고, 결과 워크북에서는 사용자 정의 색상 체계로 명확히 강조하므로 비기술자도 출력물을 쉽게 해석할 수 있습니다. 대규모 데이터 세트의 경우 API는 증분 비교 모드를 제공하여 이전 기준 이후 추가되거나 수정된 행만 비교함으로써 처리 시간과 네트워크 대역폭을 절감합니다. 또한 시각적 diff 파일 외에 구조화된 JSON 요약을 요청할 수 있어, 알림 트리거, 대시보드 업데이트, 버전 관리 시스템에 변경 사항을 전달하는 등 다운스트림 자동화에 활용할 수 있습니다. 보안 기능으로는 OAuth 2.0 베어러 토큰 인증, 범위 지정 API 키, 선택적 IP 화이트리스트가 포함되며, 저장 데이터는 AES‑256으로 암호화됩니다. 서비스는 GDPR 및 CCPA 준수 표준을 따르므로 민감한 개인 또는 재무 정보를 다룰 때 신뢰할 수 있습니다. 성능 면에서 API는 낮은 지연 시간을 목표로 설계되었으며, 수평 확장 및 인‑메모리 diff 알고리즘 덕분에 표준 크기 워크북은 대부분 1초 이내에 비교가 완료됩니다. 50 MB를 초과하는 파일에 대해서는 웹훅을 통한 비동기 처리도 지원합니다. 개발자 경험 역시 최우선이며, 포괄적인 OpenAPI 사양, 자동 생성 SDK, 상세 오류 코드, 실시간 속도 제한 헤더 등을 제공하여 최소한의 마찰로 API를 통합할 수 있습니다. 또한 샌드박스 콘솔과 방대한 샘플 저장소를 통해 배치 처리, CI/CD 파이프라인, 서버리스 함수에 대한 모범 구현을 확인할 수 있습니다. 요약하면, Comparison API는 빠르고 안전하며 개발자 친화적인 스프레드시트 diff 기능을 제공하여 형식, 크기, 복잡성에 관계없이 단 하나의 간단한 호출로 변화를 감지할 수 있게 합니다.

문서

매개변수

format: 지원되는 출력 파일 형식.
UploadFileRequest.OperationId: 이는 작업 ID입니다.
UploadFileRequest.Files: 이 파일들은 온라인 서비스에 업로드해야 하는 파일이며, 데이터를 여러분만의 방식으로 준비할 수 있지만 HTML 입력 파일 표준을 따라야 합니다.

엔드포인트 사용

파일과 액세스 토큰을 포함하는 요청을 보냅니다. 비교 API

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
서비스는 처리된 파일에 대한 다운로드 URL을 응답합니다. 이 예시에서는:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
파일 이름과 폴더 이름을 포함하는 요청을 보냅니다. 다운로드 API

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