pinakes/docs/api/photos.md
NotAShelf 7a0a009ced
docs: auto-generate API route documentation
Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: Id0d1f9769b7ccdbf83d5fa78adef62e46a6a6964
2026-03-22 17:58:40 +03:00

1.2 KiB

Photos

Photo timeline and map view

Endpoints

GET /api/v1/photos/map

Get photos in a bounding box for map view

Authentication: Required (Bearer JWT)

Parameters

Name In Required Description
lat1 query Yes Bounding box latitude 1
lon1 query Yes Bounding box longitude 1
lat2 query Yes Bounding box latitude 2
lon2 query Yes Bounding box longitude 2

Responses

Status Description
200 Map markers
400 Bad request
401 Unauthorized
500 Internal server error

GET /api/v1/photos/timeline

Get timeline of photos grouped by date

Authentication: Required (Bearer JWT)

Parameters

Name In Required Description
group_by query No Grouping: day, month, year
year query No Filter by year
month query No Filter by month
limit query No Max items (default 10000)

Responses

Status Description
200 Photo timeline groups
401 Unauthorized
500 Internal server error