تغییر اندازهٔ تصویر

Image settings and usage#

The app's image resizing settings, its limits, this month's transformations and cache hits, the cache against the team's limit, and whether Hobby's free amount is used up (originals are served).

پارامترها

• namestringمسیرالزامی

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

پاسخ

خطاها

نمونه

curl "https://api.ibel.ai/v1/apps/my-api/images" \
  -H "Authorization: Bearer $KEY"

Change image settings#

Change any of enabled, hosts, widths, qualities, formats and ttl_seconds; live within seconds. Errors 400 image_bad_*, 409 image_limit.

پارامترها

• namestringمسیرالزامی

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

بدنهٔ درخواستapplication/json

• enabledboolean
• hostsstring[]

  host names (img.example.com) or wildcards (*.example.com); https only, never addresses

• widthsinteger[]
• qualitiesinteger[]

  0–10 items

• formatsstring[]
• ttl_secondsinteger

  60–2678400

پاسخ

خطاها

نمونه

curl -X PATCH "https://api.ibel.ai/v1/apps/my-api/images" \
  -H "Authorization: Bearer $KEY" \
  -d '{"enabled":true,"hosts":["…"],"widths":[1],"qualities":[1],"formats":["webp"],"ttl_seconds":60}'

Image usage by day#

Per day: transformations (billed per 1,000), cache hits, originals served unchanged, bytes in and out.

پارامترها

• namestringمسیرالزامی

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

• daysintegerکوئری

  1–90 · default 30

پاسخ

خطاها

نمونه

curl "https://api.ibel.ai/v1/apps/my-api/images/usage" \
  -H "Authorization: Bearer $KEY"

Clear the image cache#

Forget every cached result of the app; each is made, and counted, again on its next request.

پارامترها

• namestringمسیرالزامی

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

پاسخ

خطاها

نمونه

curl -X DELETE "https://api.ibel.ai/v1/apps/my-api/images/cache" \
  -H "Authorization: Bearer $KEY"

The team''s image resizing#

Every app's transformations this month and its cache, and the team's cache against its plan limit.

پاسخ

خطاها

نمونه

curl "https://api.ibel.ai/v1/images" \
  -H "Authorization: Bearer $KEY"