Tinify Webhook Proxy

What is this?

The Tinify Webhook Proxy is a Cloudflare Worker that acts as a flexible proxy for the Tinify image compression API. It allows you to compress images using Tinify's service with added flexibility in how you submit your requests.

Features

• Supports both multipart form-data and JSON request bodies
• Accepts image sources as file uploads, URLs, or base64 encoded data
• Allows for Tinify API options like resize and metadata preservation
• Can return results directly or send them to a callback URL
• Provides flexible error handling

How to Use

You can interact with the Tinify Webhook Proxy using either multipart form-data or JSON requests. Here are examples of both:

Using multipart form-data:

curl -X POST https://your-worker.your-subdomain.workers.dev \
  -F "source=@/path/to/your/image.jpg" \
  -F "apiKey=YOUR_API_KEY" \
  -F 'resize={"method":"fit","width":300,"height":200}' \
  -F 'preserve=["copyright","creation"]' \
  -F "callbackUrl=https://your-callback-url.com/endpoint"

Using JSON:

curl -X POST https://your-worker.your-subdomain.workers.dev \
  -H "Content-Type: application/json" \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Callback-Url: https://your-callback-url.com/endpoint" \
  -d '{
    "source": {
      "url": "https://example.com/path/to/image.jpg"
    },
    "resize": {
      "method": "fit",
      "width": 300,
      "height": 200
    },
    "preserve": ["copyright", "creation"]
  }'

Parameters

• source: The image to be compressed. Can be a file upload, a URL, or base64 encoded data.
• apiKey: Your Tinify API key.
• resize (optional): Resizing options for the image.
• preserve (optional): Metadata to preserve in the compressed image.
• callbackUrl (optional): URL to send the compression results to. If not provided, results are returned directly.