Quick Start

このコンテンツはまだ日本語訳がありません。

This guide walks through the smallest end-to-end flow: create a job with remote file entries, check its status, and download the ZIP.

Prerequisites

An Eazip account (sign up free)
An API key (create one in your dashboard)

Step 1: Get Your API Key

Log in to your Eazip dashboard
Navigate to API Keys
Click Create API Key
Copy your new API key

Step 2: Create Your First Job

Make a POST request to create a ZIP job:

curl -X POST https://api.eazip.io/jobs \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "url": "https://example.com/file1.pdf",
        "filename": "invoice-001.pdf"
      },
      {
        "url": "https://example.com/file2.pdf"
      }
    ],
    "expires_in": 86400
  }'

Response (HTTP 201):

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

Step 3: Check Job Status

Poll the job status until it’s complete:

curl https://api.eazip.io/jobs/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_API_KEY"

Response when complete:

{
  "success": true,
  "job": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "files": [
      {
        "url": "https://example.com/file1.pdf",
        "filename": "invoice-001.pdf"
      },
      {
        "url": "https://example.com/file2.pdf",
        "filename": null
      }
    ],
    "url_count": 2,
    "file_count": 2,
    "fail_on_url_error": true,
    "download_url": "https://api.eazip.io/download/eyJ...",
    "zip_filename": "archive-550e8400.zip",
    "expires_at": "2025-01-22T10:00:00.000Z"
  }
}

Step 4: Download Your ZIP

Use the download_url from the response to download your ZIP file:

curl -O "https://api.eazip.io/download/eyJ..."

The download endpoint does not require your API key — the signed URL is self-authenticating.