Compress

Compress の公式ドキュメントへようこそ。Compress は、スプレッドシートファイルをワンリクエストで元のサイズのわずかな割合に縮小できる、軽量ながら強力な API です。データ駆動型の現代において、チームは単純なリストから複雑な財務モデルまで、さまざまなスプレッドシートを頻繁にやり取りしますが、そのファイルの量は隠れたコスト（アップロードの遅延、ストレージ料金の増加、下流システムでの処理時間の長期化）となります。Compress は、クラウドネイティブなサービスとして、スプレッドシートの内部構造をインテリジェントに解析し、不要な要素を取り除き、データの完全性や可読性を損なうことなく最適化されたコンパクトな形に再パッケージします。このページは、認証やリクエスト形式、エラーハンドリング、バッチ処理のベストプラクティスまで、API を効果的に利用するために必要なすべてを網羅した単一の情報源です。データパイプラインを統合するバックエンドエンジニア、ファイルアップロード時のユーザー体験を向上させたいフロントエンド開発者、組織全体のストレージオーバーヘッド削減を担う IT マネージャーなど、あらゆる役割の方に対し、ステップバイステップの手順、複数言語のコードスニペット、さまざまなスプレッドシート形式で最適な圧縮結果を得る実例を提供します。ドキュメント内では、TLS 暗号化、署名済み JWT トークン、GDPR 準拠のデータ取扱いといったセキュリティ考慮点や、異なる負荷条件下でのレイテンシとスループットを示すパフォーマンスベンチマークも掲載しています。また、よくあるシナリオをカバーする FAQ、迅速な問題診断のためのトラブルシューティングマトリクス、コミュニティフォーラムへのリンクも用意しています。ガイドを読み終えると、環境設定、正しい API 呼び出しの送信、レスポンペイロードの解釈が自信を持って行えるようになり、既存ワークフローにシームレスに圧縮処理を組み込んで、ストレージコストとネットワーク帯域幅の実質的な削減をすぐに実感できるでしょう。役割に合わせたセクションを参照し、Compress がデータ削減の重荷を担うことで、より豊かで応答性の高いアプリケーション構築に集中してください。

主な機能

Compress API の核となるのは、スプレッドシートの縮小を手間なく信頼性の高いものにする豊富な機能セットです。まず第一に、Apple Numbers、純粋な CSV/TSV、Microsoft Excel の .xlsx および .xls など、幅広いファイル形式をサポートしているため、事前変換なしで事実上すべてのスプレッドシートを送信できます。内部ではエンジンが多段階最適化を実行し、XML またはバイナリ構造を正規化し、重複スタイルを除去、同一セル書式を統合、データのない隠し行・列を削除し、画像・チャート・ピボットテーブルなど埋め込みオブジェクトをペイロードごとに最適化されたロスレス圧縮アルゴリズムでコンパクト化します。さらに、ファイルサイズを膨らませがちだが実質的な機能を持たないメタデータ、コメント、バージョン情報も自動で除去します。すべての処理はリアルタイムで行われ、最大 50 MB のファイルは数ミリ秒で結果が返り、より大きなドキュメントに対してはスロットリングと進捗コールバックでスムーズにスケールします。セキュリティは組み込みで、すべてのリクエストは HTTPS 経由で送信され、処理ウィンドウ終了後にファイルのコピーは保持されません。開発者視点では、`/compress` エンドポイントへ multipart/form‑data でファイルを添付した単一 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 の input ファイルの標準に従う必要があります。

エンドポイントの使用方法

ファイルとアクセストークンを含むリクエストを送信する 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'
ファイルが返却され、使用するか、次のワークフローのステップへ転送することができます。