변환

Metadata API는 단일 HTTP 요청만으로 스프레드시트 파일 메타데이터에 대한 완전한 제어를 손에 쥐게 해주는 개발자 친화적인 맞춤형 서비스입니다. Excel(.xlsx, .xls)과 같은 전통적인 오피스 포맷, CSV(.csv)·TSV(.tsv)와 같은 단순 구분 파일, 또는 Apple Numbers(.numbers) 문서를 다루든, API는 파일 파싱의 복잡성을 추상화하여 밀리초 단위로 핵심 설명 속성을 읽고, 추가하고, 수정할 수 있게 합니다. 수천 개의 보고서, 연구 데이터 세트 또는 재무제표를 배치 처리하면서 각 파일에 일관된 저자 정보, 제목, 주제, 설명, 키워드 목록, 그리고 애플리케이션이 정의한 사용자 정의 태그 컬렉션을 삽입할 수 있다고 상상해 보세요. 이러한 자동화 수준은 수작업 편집에 소요되는 수많은 시간을 절감할 뿐만 아니라, 클라이언트·협력자·아카이브 시스템에 전달되는 모든 파일이 인덱싱, 규정 준수, 검색 가능성을 위해 필요한 정확한 메타데이터를 포함하도록 보장합니다. 이 서비스는 원시 파일 바이트 또는 클라우드에 호스팅된 문서를 가리키는 URL을 받아들인 뒤, 원본 데이터 레이아웃이나 수식을 변경하지 않고 요청된 메타데이터 변경이 적용된 새로운 완전한 파일을 반환합니다.

주요 기능

API가 무상태이기 때문에 CI/CD 파이프라인, 서버 측 배치 작업 또는 클라이언트 측 JavaScript 위젯에 손쉽게 통합할 수 있어 웹 앱에서 내보낸 모든 데이터와 정기 백업마다 올바른 출처 정보를 포함하도록 보장합니다. 보안도 기본 제공됩니다: 모든 호출은 TLS를 통해 이루어지며 페이로드는 종단 간 암호화되고, API는 API‑키 또는 OAuth 2.0 인증을 지원해 신뢰할 수 있는 서비스에만 접근을 제한할 수 있습니다. 기본 엔진은 각 지원 포맷에 대해 고도로 최적화된 파싱 라이브러리를 활용하여 수백 개의 워크시트를 가진 대용량 Excel 통합 문서도 빠르게 처리합니다; 대부분의 일반 요청은 200 ms 이하로 완료됩니다. 실질적으로 이는 제품 내에 “메타데이터 추가” 버튼을 구축해 파일을 서비스에 전송하고, 강화된 파일을 받아 즉시 다운로드하도록 제공할 수 있음을 의미하며, 사용자는 인터페이스를 떠나지 않습니다. API는 자세한 작업 로그도 반환하므로 개발자는 프로그램적으로 예상 필드가 업데이트됐는지 확인하고, 필요 시 변경을 롤백하거나 사용자 정의 태그값에 따라 추가 처리 단계를 트리거할 수 있습니다. 통일된 언어‑비종속 REST 엔드포인트를 제공함으로써 Metadata API는 개발자가 포맷별 라이브러리를 다수 유지할 필요성을 없애고 유지 보수 부담을 감소시키며, 새로운 스프레드시트 표준이 등장해도 미래에도 호환성을 보장합니다. SaaS 공급업체가 라이선스 정보를 삽입하고자 하든, 연구 기관이 데이터 세트를 카탈로그화하든, 기업이 문서 규정 준수를 자동화하든, 이 API는 하나의 간단한 호출로 파일을 빠르고 안전하며 확장 가능하게 풍부하게 만들 수 있는 방법을 제공합니다.

문서

매개변수

AppRequest.Metadata: PropertyName 및 PropertyValue와 함께
AppRequest.MetadataJson: Metadata 구조를 사용하지 않는 경우 JSON 데이터 유형을 사용해야 합니다.
UploadFileRequest.OperationId: 이 파일들은 온라인 서비스에 업로드해야 하는 파일이며, 데이터를 자유롭게 준비할 수 있지만 HTML 입력 파일 표준을 따라야 합니다.
UploadFileRequest.Files: 이 파일들은 온라인 서비스에 업로드해야 하는 파일이며, 데이터를 자유롭게 준비할 수 있지만 HTML 입력 파일 표준을 따라야 합니다.

엔드포인트 사용

파일과 액세스 토큰을 포함한 요청을 전송합니다 메타데이터 API

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -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 }
파일 이름과 폴더 이름을 포함한 요청을 전송합니다 다운로드 API

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