Putar & Balik Gambar

Putar gambar pada sudut sembarang dan/atau balik secara horizontal atau vertikal. Operasi rotasi dan pembalikan dapat digabungkan dalam satu permintaan.

API Endpoint

POST /api/v1/tools/image/rotate

Menerima multipart form data dengan berkas gambar dan field JSON settings.

Parameters

Parameter	Type	Required	Default	Description
angle	number	No	0	Sudut rotasi dalam derajat (searah jarum jam). Menerima nilai numerik apa pun.
horizontal	boolean	No	false	Balik gambar secara horizontal (cermin)
vertical	boolean	No	false	Balik gambar secara vertikal

Example Request

Putar 90 derajat searah jarum jam:

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"angle": 90}'

Balik secara horizontal:

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"horizontal": true}'

Putar dan balik sekaligus:

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"angle": 45, "vertical": true}'

Example Response

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

Notes

• Rotasi diterapkan terlebih dahulu, lalu operasi pembalikan.
• Rotasi non-90-derajat (mis. 45 derajat) akan memperbesar kanvas agar pas dengan gambar yang diputar, dengan isian transparan atau hitam tergantung format output.
• Nilai umum: 90, 180, 270 untuk rotasi seperempat putaran.
• Orientasi EXIF diterapkan otomatis sebelum diproses, sehingga rotasi relatif terhadap orientasi visual.