इमेज कंप्रेशन API

अपने डैशबोर्ड में API की बनाएँ, फिर HTTP Basic प्रमाणीकरण (यूज़र api, पासवर्ड = की) इस्तेमाल करें या Authorization: Bearer <key> भेजें।

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

इमेज को अनुरोध बॉडी के रूप में /api/v1/shrink पर POST करें। वैकल्पिक क्वेरी पैरामीटर: level (fast / default / best) और filename।

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

सफल अनुरोध आमतौर पर status done के साथ 201 लौटाते हैं। Location हेडर और output.url डाउनलोड की ओर इशारा करते हैं। Compression-Count इस महीने का आपका इस्तेमाल है।

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"
}

स्वीकृत और इंतज़ार में: 202

लंबी कतार होने पर status pending के साथ 202 Accepted लौट सकता है। Location डाउनलोड नहीं, जॉब की स्थिति की ओर इशारा करता है। इमेज दोबारा भेजने के बजाय यह URL रखें और इसे पोल करें।

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"
}

जॉब की स्थिति पोल करें

Location में लौटे URL पर हर 1–2 सेकंड में GET /api/v1/results/{id} भेजें। pending का मतलब कतार में (queuePosition मौजूदा स्थान बताता है); processing का मतलब कंप्रेशन चल रहा है। status done होने पर downloadUrl से डाउनलोड करें। failed का मतलब जॉब पूरा नहीं हो सका; failure श्रेणी बताता है और note कारण समझाता है।

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

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

नतीजे अवधि ख़त्म होने तक डाउनलोड किए जा सकते हैं; उसके बाद URL 410 लौटाता है।

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

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