Full HTML content...
","created_at":"2025-01-15T10:00:00.000Z","view_count":43,"reading_time":3,"category_name":"News","author_name":"admin"}}},"404":{"description":"Article not found"}}}},"/api/albums":{"get":{"summary":"List all albums","description":"Returns all published albums ordered by release date (newest first), with track counts.","category":"Music","auth":false,"parameters":[{"name":"limit","in":"query","type":"integer","description":"Max albums to return (max: 100)"},{"name":"featured","in":"query","type":"boolean","description":"Filter featured albums only"}],"responses":{"200":{"description":"List of albums","example":{"success":true,"data":[{"id":1,"title":"Album Title","slug":"album-slug","release_date":"1982-01-01","year":"1982","cover_image":"/audio/path/Covers/1.jpg","track_count":12}]}}}}},"/api/albums/:slug":{"get":{"summary":"Get album by slug or ID","description":"Returns album details with all tracks, including audio file paths, durations, and lyrics availability.","category":"Music","auth":false,"parameters":[{"name":"slug","in":"path","type":"string","required":true,"description":"Album slug or numeric ID"}],"responses":{"200":{"description":"Album with tracks","example":{"success":true,"data":{"id":1,"title":"Album Title","slug":"album-slug","description":"Album description...","release_date":"1982-01-01","cover_image":"/audio/path/Covers/1.jpg","tracks":[{"id":1,"title":"Track 1","track_number":1,"duration":"4:32","audio_file":"/audio/path/track.mp3","artist":"Oblachny Kray"}],"total_duration_formatted":"45:12"}}},"404":{"description":"Album not found"}}}},"/api/tracks/random":{"get":{"summary":"Get random tracks","description":"Returns a set of random tracks with album metadata. Useful for discovery features.","category":"Music","auth":false,"parameters":[{"name":"count","in":"query","type":"integer","description":"Number of tracks (default: 5, max: 20)"}],"responses":{"200":{"description":"Random tracks array","example":{"success":true,"data":[{"id":42,"title":"Track Title","duration":"3:45","audio_file":"/audio/path/track.mp3","album_title":"Album Name","album_slug":"album-slug","artist":"Oblachny Kray"}]}}}}},"/api/lyrics/browse":{"get":{"summary":"Browse lyrics","description":"Returns all tracks with lyrics, grouped by album. Supports search within lyrics text and filtering by album.","category":"Music","auth":false,"parameters":[{"name":"search","in":"query","type":"string","description":"Search within lyrics text"},{"name":"album","in":"query","type":"string","description":"Filter by album slug"}],"responses":{"200":{"description":"Lyrics grouped by album","example":{"success":true,"data":[{"album_id":1,"album_title":"Album Name","album_slug":"album-slug","cover_image":"/audio/path/Covers/1.jpg","tracks":[{"id":1,"title":"Song","track_number":1,"snippet":"First line / Second line"}]}],"meta":{"total_tracks":146,"total_albums":15}}}}}},"/api/members":{"get":{"summary":"List band members","description":"Returns all band members with their roles and activity status, ordered by sort order.","category":"Band","auth":false,"parameters":[],"responses":{"200":{"description":"List of band members","example":{"success":true,"data":[{"id":1,"name":"Member Name","slug":"member-slug","role":"guitar","years_active":"1978-2011","photo_url":"/images/members/photo.jpg","is_deceased":1}]}}}}},"/api/members/:slug":{"get":{"summary":"Get band member by slug","description":"Returns detailed profile of a band member including biography, instruments, discography, and gallery.","category":"Band","auth":false,"parameters":[{"name":"slug","in":"path","type":"string","required":true,"description":"Member URL slug"}],"responses":{"200":{"description":"Detailed member profile","example":{"success":true,"data":{"id":1,"name":"Member Name","slug":"member-slug","role":"guitar","years_active":"1978-2011","biography":"Full biography text...","instruments":["Electric Guitar","Acoustic Guitar"],"is_deceased":1}}},"404":{"description":"Member not found"}}}},"/api/events":{"get":{"summary":"List events","description":"Returns published events (concerts, festivals, etc.) ordered by date, with optional pagination.","category":"Band","auth":false,"parameters":[{"name":"limit","in":"query","type":"integer","description":"Max events to return (default: 10, max: 100)"},{"name":"page","in":"query","type":"integer","description":"Page number (default: 1)"}],"responses":{"200":{"description":"List of events","example":{"success":true,"data":[{"id":1,"title":"Concert in Podolsk","slug":"concert-podolsk-1987","event_date":"1987-09-12","venue":"Podolsk Stadium","city":"Podolsk"}]}}}}},"/api/search":{"get":{"summary":"Global search","description":"Searches across all content types (articles, albums, tracks, events, members, photos) using FTS5 full-text search with BM25 ranking.","category":"Search","auth":false,"parameters":[{"name":"q","in":"query","type":"string","required":true,"description":"Search query (min 2 characters)"},{"name":"category","in":"query","type":"string","description":"Filter: all, news, music, photos, events, members"},{"name":"limit","in":"query","type":"integer","description":"Max results (default: 20, max: 100)"},{"name":"lang","in":"query","type":"string","description":"Language for URLs: ru or en (default: ru)"}],"responses":{"200":{"description":"Search results sorted by type priority and relevance","example":{"success":true,"data":[{"type":"album","title":"Ygyatta","description":"...","url":"/ru/albums/ygyatta","metadata":"2011"}],"meta":{"query":"ygyatta","category":"all","fts":true,"count":3,"total":3}}},"400":{"description":"Query too short (< 2 chars)"}}}},"/api/search/suggest":{"get":{"summary":"Search suggestions","description":"Returns typeahead autocomplete suggestions from articles, albums, tracks, and members. Limited to 8 results.","category":"Search","auth":false,"parameters":[{"name":"q","in":"query","type":"string","required":true,"description":"Partial search query (min 2 chars)"},{"name":"lang","in":"query","type":"string","description":"Language for URLs (default: ru)"}],"responses":{"200":{"description":"Suggestion list","example":{"success":true,"data":[{"text":"Album Name","type":"album","url":"/ru/albums/slug"}]}}}}},"/api/health":{"get":{"summary":"Health check","description":"Returns server health status including database connectivity, memory usage, and uptime.","category":"System","auth":false,"parameters":[],"responses":{"200":{"description":"Healthy status","example":{"status":"ok","timestamp":"2026-03-16T12:00:00.000Z","service":"okrock-website","uptime":86400,"database":{"status":"connected","latency_ms":2},"memory":{"used":"45 MB","total":"80 MB"}}},"503":{"description":"Service unhealthy"}}}},"/api/site-stats":{"get":{"summary":"Site statistics","description":"Returns comprehensive site-wide statistics: total counts for tracks, albums, events, articles, members, photos, and more.","category":"System","auth":false,"parameters":[],"responses":{"200":{"description":"Site statistics","example":{"success":true,"data":{"total_tracks":246,"total_albums":19,"total_concerts":20,"total_articles":92,"total_members":13,"years_active":48,"last_updated":"2026-03-16T12:00:00.000Z"}}}}}},"/api/version":{"get":{"summary":"API version","description":"Returns current API version, Node.js version, service worker version, and server uptime.","category":"System","auth":false,"parameters":[],"responses":{"200":{"description":"Version info","example":{"version":"1.6.0","node":"v22.0.0","sw":"v7.13.0","api":"1.0","uptime":86400}}}}},"/feed/rss":{"get":{"summary":"RSS 2.0 feed","description":"Returns the latest articles as an RSS 2.0 XML feed. Autodiscovery link available in HTML head.","category":"Feeds","auth":false,"parameters":[],"responses":{"200":{"description":"RSS 2.0 XML","example":"