NotAShelf
934691c0f9
Signed-off-by: NotAShelf <raf@notashelf.dev> Change-Id: Id0d1f9769b7ccdbf83d5fa78adef62e46a6a6964
57 lines
1.2 KiB
Markdown
57 lines
1.2 KiB
Markdown
# 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 |
|
|
|
|
---
|
|
|