NotAShelf
9e5eb41d39
Signed-off-by: NotAShelf <raf@notashelf.dev> Change-Id: I4806c58aa0a17f504c9312723ad770166a6a6964
56 lines
1.4 KiB
Markdown
Vendored
56 lines
1.4 KiB
Markdown
Vendored
# 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 |
|
|
|
|
---
|