API · stage-images
Operações de stage-images do contrato OpenAPI que aceitam uma chave de API.
Atualizado:
Imágenes de fondo de «Marcar sobre imagen» (FIU-661). Son del negocio de la credencial; el ítem sketch guarda solo el id.
POST /stage-images
Subir una imagen de fondo para «Marcar sobre imagen»
PNG/JPEG/WebP real (tipo verificado por bytes), máximo 2 MiB y 16 megapíxeles; se re-encoda sin metadatos y con 1600 px de lado como mucho (conserva la transparencia). Devuelve el id que va en sketch_background del ítem sketch; la imagen es del negocio de la credencial y no se publica hasta guardar el flujo. Permiso flows:write o scope settings:write. 30 subidas por minuto por negocio.
- Autenticação: Chave de API ou sessão do painel
- Escopos:
settings:write,flows:write
Corpo da solicitação (obrigatório)
image/png: stringimage/jpeg: stringimage/webp: string
Respostas
| Status | Descrição |
|---|---|
201 | Imagen guardada y auditada (flow.stage_image_uploaded) (StageImageOut) |
401 | Error (RFC 9457) (Problem) |
403 | Error (RFC 9457) (Problem) |
413 | Error (RFC 9457) (Problem) |
422 | Error (RFC 9457) (Problem) |
429 | Error (RFC 9457) (Problem) |
503 | Error (RFC 9457) (Problem) |
GET /stage-images/{id}
Descargar una imagen de fondo de «Marcar sobre imagen»
La lee quien completa etapas, con la cache privada y ETag. El id de otro negocio responde 404 stage_image_not_found. Permiso flows:stage_image_read o scope config:read.
- Autenticação: Chave de API ou sessão do painel
- Escopos:
config:read
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
id | path | Sim | string |
Respostas
| Status | Descrição |
|---|---|
200 | Bytes de la imagen (image/jpeg o image/png) (string) |
304 | Sin cambios (If-None-Match) |
401 | Error (RFC 9457) (Problem) |
403 | Error (RFC 9457) (Problem) |
404 | Error (RFC 9457) (Problem) |
503 | Error (RFC 9457) (Problem) |