For developers
API imgsize.cc
Một danh mục công khai, nhỏ gọn, miễn phí, không cần xác thực của mọi preset nền tảng trên imgsize.cc — kích thước pixel chính xác, tỉ lệ khung hình, kích thước file tối đa, định dạng được hỗ trợ và yêu cầu nền cho Amazon Main Image, Instagram Reel, YouTube Thumbnail, LinkedIn Cover và hơn 80 cái khác.
1. Danh mục preset đầy đủ
Trả về tất cả preset trong một lần gọi. Dùng khi bạn cần khám phá những gì imgsize.cc hỗ trợ.
GET /api/presets.json public · cache 1h 2. Chi tiết một preset
Trả về toàn bộ bản ghi preset bao gồm mô tả SEO dài và các quy tắc nền theo từng nền tảng.
GET /api/preset/{slug}.json public · cache 1h 3. Cấu trúc phản hồi
Mỗi preset trong /api/presets.json bao gồm các trường sau:
| Field | Type | Example |
|---|---|---|
| slug | string | "amazon-main" |
| title | string | "Amazon Main Image" |
| category | string | "marketplace" |
| dimensions | string | "2000×2000" |
| aspect | string | "1:1" |
| maxSize | string | "10 MB" |
| formats | string | "JPEG, PNG, TIFF, GIF" |
| background | string | "Pure white (RGB 255,255,255)" |
Mẫu tích hợp
Không xác thực, không giới hạn tần suất, CORS mở. Chỉ là danh mục tĩnh.
- Không xác thực, không giới hạn tần suất. Đây là danh mục tĩnh. Cache ở phía bạn 24 giờ; làm mới khi cần.
- CORS mở. Mỗi endpoint phục vụ Access-Control-Allow-Origin: *, vì vậy bạn có thể truy xuất từ script trình duyệt.
- Không có API xử lý ảnh. imgsize.cc xử lý ảnh trong trình duyệt qua Canvas API; chúng tôi không cung cấp endpoint resize được lưu trữ. Danh mục cho code của bạn biết cần resize về kích thước nào; việc resize thực sự diễn ra phía client hoặc trên backend của riêng bạn.
- Tên slug ổn định. Slug có phiên bản — một khi đã xuất bản, chúng tôi không đổi tên. Preset mới sẽ đi kèm slug mới.
- Dùng trang SEO cho văn xuôi. Nếu bạn cần mô tả dễ đọc, hãy liên kết tới /presets/{slug} thay vì nhúng văn bản của chúng tôi.
Tích hợp không cần code
Sắp ra mắt: các tích hợp chính thức của Zapier, Make, và n8n kết nối danh mục với quy trình xử lý ảnh của bạn. hello@imgsize.cc.