For developers
A API do imgsize.cc
Um catálogo público, pequeno, gratuito e sem autenticação de cada preset de plataforma no imgsize.cc — as dimensões exatas em pixels, proporção, tamanho máximo de arquivo, formatos suportados e requisito de fundo para Amazon Main Image, Instagram Reel, YouTube Thumbnail, LinkedIn Cover e mais de 80 outros.
1. Catálogo completo de presets
Retorna todos os presets em uma chamada. Use isso quando precisar descobrir o que o imgsize.cc suporta.
GET /api/presets.json public · cache 1h 2. Detalhe de um preset
Retorna o registro completo do preset incluindo a descrição SEO longa e as regras de fundo cientes da plataforma.
GET /api/preset/{slug}.json public · cache 1h 3. Formato da resposta
Cada preset em /api/presets.json inclui estes campos:
| 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)" |
Padrões de integração
Sem autenticação, sem limite de taxa, CORS aberto. Apenas um catálogo estático.
- Sem autenticação, sem limite de taxa. É um catálogo estático. Faça cache no seu lado por 24 horas; atualize quando precisar.
- CORS aberto. Cada endpoint serve Access-Control-Allow-Origin: *, então você pode buscar a partir de scripts do navegador.
- Sem API de processamento de imagens. imgsize.cc faz o trabalho de imagem no navegador via Canvas API; não expomos um endpoint de redimensionamento hospedado. O catálogo diz ao seu código o que redimensionar; o redimensionamento real acontece no cliente ou em seu próprio backend.
- Nomes slug estáveis. Slugs têm versão — uma vez publicado, não renomeamos. Adicionaremos novos presets com novos slugs.
- Use a página SEO para prosa. Se precisar de uma descrição legível, vincule para /presets/{slug} em vez de embeber nosso texto.
Integrações sem código
Em breve: integrações oficiais de Zapier, Make e n8n que conectam o catálogo ao seu fluxo de processamento de imagens. hello@imgsize.cc.