API Pemampatan Imej

Cipta kunci API dalam papan pemuka anda, kemudian gunakan pengesahan HTTP Basic (pengguna api, kata laluan = kunci) atau hantar Authorization: Bearer <key>.

curl --user api:YOUR_API_KEY ...
# or
curl -H "Authorization: Bearer YOUR_API_KEY" ...

Hantar imej dengan POST sebagai badan permintaan ke /api/v1/shrink. Parameter pertanyaan pilihan: level (fast / default / best) dan filename.

curl -i --user api:YOUR_API_KEY \
  --data-binary @photo.jpg \
  "https://bitinz.com/api/v1/shrink?level=default&filename=photo.jpg"

Permintaan yang berjaya biasanya memulangkan 201 dengan status done. Pengepala Location dan output.url menunjuk ke muat turun. Compression-Count ialah penggunaan anda bulan ini.

HTTP/1.1 201 Created
Location: https://bitinz.com/api/v1/results/<id>/download
Compression-Count: 1

{
  "id": "<id>",
  "status": "done",
  "input":  { "size": 2277375, "type": "image/jpeg" },
  "output": { "size": 992450, "type": "image/jpeg", "ratio": 0.436,
              "url": "https://bitinz.com/api/v1/results/<id>/download" },
  "unchanged": false,
  "expiresAt": "2026-10-02T12:00:00Z"
}

Diterima dan menunggu: 202

Baris gilir yang lebih panjang boleh memulangkan 202 Accepted dengan status pending. Location menunjuk ke status kerja, bukan ke muat turun. Simpan URL ini dan tinjaunya, bukannya menghantar imej sekali lagi.

HTTP/1.1 202 Accepted
Location: https://bitinz.com/api/v1/results/<id>

{
  "id": "<id>",
  "status": "pending",
  "input": { "size": 2277375 },
  "expiresAt": "2026-10-02T12:00:00Z"
}

Tinjau status kerja

Hantar GET /api/v1/results/{id} ke URL yang dipulangkan dalam Location setiap 1–2 saat. pending bermaksud dalam baris gilir (queuePosition memberi kedudukan semasanya); processing bermaksud pemampatan sedang berjalan. Apabila status ialah done, muat turun daripada downloadUrl. failed bermaksud kerja tidak dapat diselesaikan; failure mengenal pasti kategori dan note menerangkan sebabnya.

curl "https://bitinz.com/api/v1/results/<id>"

{
  "id": "<id>",
  "status": "done",
  "available": true,
  "downloadUrl": "/api/v1/results/<id>/download",
  "outputSize": 992450,
  "unchanged": false
}

Hasil boleh dimuat turun sehingga tamat tempoh; selepas itu URL memulangkan 410.

curl -o photo.min.jpg "https://bitinz.com/api/v1/results/<id>/download"

{ "error": { "code": "...", "message": "..." } }