API — Fotkus

GET /api/prefixes/limits Allowed prefix lifetime

Example

→ 200 {"min_hours":1,"max_hours":5}

POST /api/prefixes Create a personal prefix

Parameter	in	type
`base`	body	string	transliterated, spaces → “_”, a unique tail is appended
`ttl_hours`	body	int	hours, within /api/prefixes/limits

Example

{"base":"москва красная площадь","ttl_hours":3}
→ 201 {"prefix":"moskva_krasnaya_ploschad_1a2b3c4d","expires_at":"2026-07-06T18:00:00Z"}

POST /api/albums Create an album

Parameter	in	type
`prefix`	body	string	live prefix: goes into the title and the prefix field
`title`	body	string	title (defaults to date-time)
`password`	body	string	viewing password (optional)
`lat, lon`	body	float	album coordinates

Example

{"title":"Obj_1","prefix":"moskva_krasnaya_ploschad_1a2b3c4d","lat":55.711273,"lon":37.600893}
→ 201 {"album":{"id":"…","url":"…"},"owner_token":"…"}

GET /api/export/albums Export a series by prefix 🔑

Parameter	in	type
`prefix`*	query	string	series prefix

Example

→ 200 {"total":1,"albums":[{
  "id":"…","title":"…","lat":55.711273,"lon":37.600893,
  "place":"…","pois":[{"name":"…","kind":"school","dist":120}],
  "photos":[{"id":"…","original_url":"…/i/…","lat":55.711273,"lon":37.600893}],
  "zip_url":"…","delete_url":"…"}]}

GET /api/export/albums/{id} Export one album of a series 🔑

Parameter	in	type
`id`*	path	string	album id