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.4 KiB
Markdown
109 lines
4.4 KiB
Markdown
---
|
|
description: "Redigera EXIF-, IPTC-, GPS- och XMP-metadatafält i bilder utan att koda om pixlarna."
|
|
i18n_source_hash: a37746db11c3
|
|
i18n_provenance: human
|
|
i18n_output_hash: e19a6cf535ce
|
|
---
|
|
|
|
# Redigera metadata {#edit-metadata}
|
|
|
|
Redigera bildmetadatafält inklusive EXIF, IPTC, GPS-koordinater, datum och nyckelord. Använder ExifTool i bakgrunden, så metadata skrivs på plats utan att koda om pixlar, vilket bevarar full bildkvalitet.
|
|
|
|
## API-slutpunkter {#api-endpoints}
|
|
|
|
### Redigera metadata {#edit-metadata-1}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata`
|
|
|
|
Skriver metadatafält till bilden och returnerar den ändrade filen.
|
|
|
|
### Inspektera metadata {#inspect-metadata}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata/inspect`
|
|
|
|
Returnerar den fullständiga metadatan från bilden via ExifTool som JSON. Ändrar inte bilden.
|
|
|
|
## Parametrar (Redigera) {#parameters-edit}
|
|
|
|
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
|
|-----------|------|----------|---------|-------------|
|
|
| title | string | Nej | - | Bildtitel (XMP/EXIF) |
|
|
| author | string | Nej | - | Författarnamn |
|
|
| artist | string | Nej | - | Konstnärsnamn (EXIF Artist-tagg) |
|
|
| copyright | string | Nej | - | Upphovsrättsmeddelande |
|
|
| imageDescription | string | Nej | - | Bildbeskrivning (EXIF) |
|
|
| software | string | Nej | - | Programvarutagg |
|
|
| dateTime | string | Nej | - | EXIF DateTime-värde |
|
|
| dateTimeOriginal | string | Nej | - | EXIF DateTimeOriginal-värde |
|
|
| setAllDates | string | Nej | - | Ange alla datumfält samtidigt |
|
|
| dateShift | string | Nej | - | Förskjut alla datum med en offset (format: `+HH:MM` eller `-HH:MM`) |
|
|
| clearGps | boolean | Nej | `false` | Ta bort all GPS-data |
|
|
| gpsLatitude | number | Nej | - | Ange GPS-latitud (-90 till 90) |
|
|
| gpsLongitude | number | Nej | - | Ange GPS-longitud (-180 till 180) |
|
|
| gpsAltitude | number | Nej | - | Ange GPS-höjd i meter |
|
|
| keywords | string[] | Nej | - | Nyckelord/taggar att lägga till eller ange |
|
|
| keywordsMode | string | Nej | `"add"` | Hur nyckelord hanteras: `add` (lägg till) eller `set` (ersätt) |
|
|
| fieldsToRemove | string[] | Nej | `[]` | Lista över specifika metadatafältnamn att ta bort |
|
|
| iptcTitle | string | Nej | - | IPTC Object Name |
|
|
| iptcHeadline | string | Nej | - | IPTC Headline |
|
|
| iptcCity | string | Nej | - | IPTC City |
|
|
| iptcState | string | Nej | - | IPTC Province/State |
|
|
| iptcCountry | string | Nej | - | IPTC Country |
|
|
|
|
## Exempelbegäran {#example-request}
|
|
|
|
Ange författare och upphovsrätt:
|
|
|
|
```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"}'
|
|
```
|
|
|
|
Ange GPS-koordinater:
|
|
|
|
```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}'
|
|
```
|
|
|
|
Ta bort GPS och lägg till nyckelord:
|
|
|
|
```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"}'
|
|
```
|
|
|
|
Inspektera metadata:
|
|
|
|
```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"
|
|
```
|
|
|
|
## Exempelsvar (Redigera) {#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
|
|
}
|
|
```
|
|
|
|
## Anteckningar {#notes}
|
|
|
|
- Detta verktyg kräver att ExifTool är installerat på servern. Det ingår i Docker-avbildningen.
|
|
- Metadata skrivs på plats, så ingen omkodning av pixlar sker. Ändringen av filstorleken är minimal (bara metadatabyten).
|
|
- Parametern `dateShift` förskjuter alla datumfält med den angivna offseten, vilket är användbart för att korrigera tidszonsfel (t.ex. `+02:00` eller `-05:30`).
|
|
- Om inga ändringar begärs (alla parametrar utelämnade eller tomma) returneras originalfilen oförändrad.
|
|
- Format som stöds: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
|
|
- För format som inte kan förhandsgranskas i webbläsaren (HEIF, TIFF) inkluderar svaret ett `previewUrl`-fält med en WebP-förhandsgranskning.
|