mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
109 lines
4.6 KiB
Markdown
109 lines
4.6 KiB
Markdown
---
|
|
description: "Edita campos de metadatos EXIF, IPTC, GPS y XMP en imágenes sin recodificar los píxeles."
|
|
i18n_source_hash: a37746db11c3
|
|
i18n_provenance: human
|
|
i18n_output_hash: 9ee294905c8a
|
|
---
|
|
|
|
# Editar metadatos {#edit-metadata}
|
|
|
|
Edita campos de metadatos de imagen, incluidos EXIF, IPTC, coordenadas GPS, fechas y palabras clave. Usa ExifTool internamente, por lo que los metadatos se escriben en el sitio sin recodificar los píxeles, preservando la calidad completa de la imagen.
|
|
|
|
## Endpoints de la API {#api-endpoints}
|
|
|
|
### Editar metadatos {#edit-metadata-1}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata`
|
|
|
|
Escribe campos de metadatos en la imagen y devuelve el archivo modificado.
|
|
|
|
### Inspeccionar metadatos {#inspect-metadata}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata/inspect`
|
|
|
|
Devuelve todos los metadatos de la imagen mediante ExifTool como JSON. No modifica la imagen.
|
|
|
|
## Parámetros (Editar) {#parameters-edit}
|
|
|
|
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|
|
|-----------|------|----------|---------|-------------|
|
|
| title | string | No | - | Título de la imagen (XMP/EXIF) |
|
|
| author | string | No | - | Nombre del autor |
|
|
| artist | string | No | - | Nombre del artista (etiqueta EXIF Artist) |
|
|
| copyright | string | No | - | Aviso de derechos de autor |
|
|
| imageDescription | string | No | - | Descripción de la imagen (EXIF) |
|
|
| software | string | No | - | Etiqueta de software |
|
|
| dateTime | string | No | - | Valor EXIF DateTime |
|
|
| dateTimeOriginal | string | No | - | Valor EXIF DateTimeOriginal |
|
|
| setAllDates | string | No | - | Establece todos los campos de fecha a la vez |
|
|
| dateShift | string | No | - | Desplaza todas las fechas por un valor de compensación (formato: `+HH:MM` o `-HH:MM`) |
|
|
| clearGps | boolean | No | `false` | Elimina todos los datos GPS |
|
|
| gpsLatitude | number | No | - | Establece la latitud GPS (-90 a 90) |
|
|
| gpsLongitude | number | No | - | Establece la longitud GPS (-180 a 180) |
|
|
| gpsAltitude | number | No | - | Establece la altitud GPS en metros |
|
|
| keywords | string[] | No | - | Palabras clave/etiquetas que se añaden o establecen |
|
|
| keywordsMode | string | No | `"add"` | Cómo tratar las palabras clave: `add` (añadir) o `set` (reemplazar) |
|
|
| fieldsToRemove | string[] | No | `[]` | Lista de nombres específicos de campos de metadatos que se eliminan |
|
|
| iptcTitle | string | No | - | IPTC Object Name |
|
|
| iptcHeadline | string | No | - | IPTC Headline |
|
|
| iptcCity | string | No | - | IPTC City |
|
|
| iptcState | string | No | - | IPTC Province/State |
|
|
| iptcCountry | string | No | - | IPTC Country |
|
|
|
|
## Ejemplo de solicitud {#example-request}
|
|
|
|
Establecer autor y derechos de autor:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"author": "Jane Smith", "copyright": "2024 Jane Smith"}'
|
|
```
|
|
|
|
Establecer coordenadas GPS:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"gpsLatitude": 48.8566, "gpsLongitude": 2.3522, "gpsAltitude": 35}'
|
|
```
|
|
|
|
Eliminar GPS y añadir palabras clave:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"clearGps": true, "keywords": ["landscape", "sunset"], "keywordsMode": "add"}'
|
|
```
|
|
|
|
Inspeccionar metadatos:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg"
|
|
```
|
|
|
|
## Ejemplo de respuesta (Editar) {#example-response-edit}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
|
|
"originalSize": 2450000,
|
|
"processedSize": 2452000
|
|
}
|
|
```
|
|
|
|
## Notas {#notes}
|
|
|
|
- Esta herramienta requiere que ExifTool esté instalado en el servidor. Está incluido en la imagen de Docker.
|
|
- Los metadatos se escriben en el sitio, por lo que no se produce recodificación de píxeles. El cambio en el tamaño del archivo es mínimo (solo los bytes de metadatos).
|
|
- El parámetro `dateShift` desplaza todos los campos de fecha por la compensación especificada, útil para corregir errores de zona horaria (p. ej. `+02:00` o `-05:30`).
|
|
- Si no se solicitan cambios (todos los parámetros omitidos o vacíos), el archivo original se devuelve sin cambios.
|
|
- Formatos admitidos: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
|
|
- Para los formatos que no se pueden previsualizar en el navegador (HEIF, TIFF), la respuesta incluye un campo `previewUrl` con una vista previa WebP.
|