mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

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.

2026-07-11 13:52:47 +08:00

2.3 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Snijd afbeeldingen bij door een gebied met positie en afmetingen op te geven.	aab38ccd7c53	human	132d91d80d4e

Bijsnijden

Snijd afbeeldingen bij door een rechthoekig gebied te definiëren met positie en grootte. Ondersteunt zowel pixel- als percentage-eenheden.

API-eindpunt

POST /api/v1/tools/image/crop

Accepteert multipart-formuliergegevens met een afbeeldingsbestand en een JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
left	number	Ja	-	X-offset van het uitsnijgebied (vanaf de linkerrand)
top	number	Ja	-	Y-offset van het uitsnijgebied (vanaf de bovenrand)
width	number	Ja	-	Breedte van het uitsnijgebied
height	number	Ja	-	Hoogte van het uitsnijgebied
unit	string	Nee	`"px"`	Eenheid voor de waarden: `px` of `percent`

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 100, "top": 50, "width": 800, "height": 600}'

Bijsnijden met percentagewaarden:

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 10, "top": 10, "width": 80, "height": 80, "unit": "percent"}'

Voorbeeldantwoord

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 1200000
}

Opmerkingen

Het uitsnijgebied moet binnen de grenzen van de afbeelding vallen. Als het gebied buiten de afbeelding valt, mislukt het verzoek.
Bij gebruik van de eenheid percent vertegenwoordigen de waarden percentages van de afbeeldingsafmetingen (bijv. left: 10 betekent 10% vanaf de linkerrand).
Het uitvoerformaat komt overeen met het invoerformaat.
De EXIF-oriëntatie wordt automatisch toegepast vóór het bijsnijden, zodat de coördinaten overeenkomen met de visueel correcte oriëntatie.

2.3 KiB Raw Blame History