mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2.3 KiB
2.3 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Rota imágenes en cualquier ángulo y voltéalas horizontal o verticalmente. | af2581d7cd8d | human | e8b33640b0cc |
Rotar y voltear
Rota imágenes en un ángulo arbitrario o voltéalas horizontal o verticalmente. Las operaciones de rotación y volteo se pueden combinar en una sola solicitud.
Endpoint de la API
POST /api/v1/tools/image/rotate
Acepta datos de formulario multipart con un archivo de imagen y un campo JSON settings.
Parámetros
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| angle | number | No | 0 |
Ángulo de rotación en grados (en sentido horario). Acepta cualquier valor numérico. |
| horizontal | boolean | No | false |
Voltear la imagen horizontalmente (espejo) |
| vertical | boolean | No | false |
Voltear la imagen verticalmente |
Ejemplo de solicitud
Rotar 90 grados en sentido horario:
curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"angle": 90}'
Voltear horizontalmente:
curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"horizontal": true}'
Rotar y voltear a la vez:
curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"angle": 45, "vertical": true}'
Ejemplo de respuesta
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
"originalSize": 2450000,
"processedSize": 2480000
}
Notas
- Primero se aplica la rotación y luego las operaciones de volteo.
- Las rotaciones que no son de 90 grados (por ejemplo, 45 grados) ampliarán el lienzo para ajustarse a la imagen rotada, con relleno transparente o negro según el formato de salida.
- Valores comunes: 90, 180, 270 para rotaciones de cuarto de vuelta.
- La orientación EXIF se aplica automáticamente antes del procesamiento, por lo que la rotación es relativa a la orientación visual.