Öffentliche Read-API für die aktuellen Endpunkte

Diese Dokumentation beschreibt die öffentlichen Read-Endpunkte unter /api/request/. Antworten sind JSON, sofern nichts anderes angegeben ist.

Endpoints API-Bedingungen Impressum Datenschutzerklärung Nutzungsbedingungen

playlist_v2.php

/api/request/playlist_v2.php

GET

Zentrale Song-Listing-API. Kann alle Songs, eine Playlist, ein Album, ein Artist-/Persona-Profil oder einen Mood-Feed liefern. Ohne Hauptfilter liefert der Endpoint den aktuellen Song-Feed.

Parameter	Typ	Beschreibung
`playlist`	string	Playlist-UUID.
`album`	integer	Album-ID.
`artist`	integer	Artist- oder Persona-ID.
`mood`	integer	Optionaler Mood-Filter; allein genutzt ergibt er einen Mood-Feed.
`search`	string	Suche über Song, Artist, Mood und Album.
`offset`	integer	Standard 0.
`limit`	integer	Standard 20.

GET https://music.boocord.com/api/request/playlist_v2.php?playlist=9b66d5d3-1f2c-4af0-a13a-4f6e64a5db61
GET https://music.boocord.com/api/request/playlist_v2.php?album=12
GET https://music.boocord.com/api/request/playlist_v2.php?artist=7&search=night
GET https://music.boocord.com/api/request/playlist_v2.php?mood=3&limit=10

Hinweise

playlistType ist je nach Kontext z. B. songs, playlist, album, artist_profile oder mood.
Je nach Modus können Zusatzfelder wie albumId, artistProfileId, artistProfileType, artistProfileUsesAi, moodId oder moodCover vorkommen.

song_v2.php

/api/request/song_v2.php

GET

Liefert die Detaildaten zu genau einem Song.

Parameter	Typ	Beschreibung
`id`	integer	Pflichtfeld. Song-ID.

GET https://music.boocord.com/api/request/song_v2.php?id=991

Hinweise

Liefert 400, falls id fehlt, und 404, falls der Song nicht existiert.
Wiedergabezähler werden aus Kompatibilitätsgründen in snake_case und camelCase geliefert.

albums.php

/api/request/albums.php

GET

Album-Listing mit Suche, Artist-Filter, Mood-Filter und Sortierung.

Parameter	Typ	Beschreibung
`search`	string	Suche über Albumname, Beschreibung oder Artist.
`artist`	integer	Filter auf eine Artist-ID.
`mood`	integer	Nur Alben mit mindestens einem Song dieser Mood.
`sort`	string	latest, title oder songs. Standard latest.
`offset`	integer	Standard 0.
`limit`	integer	1 bis 100, Standard 24.

GET https://music.boocord.com/api/request/albums.php?artist=7&sort=songs

artists.php

/api/request/artists.php

GET

Directory für Artist- und Persona-Profile.

Parameter	Typ	Beschreibung
`kind`	string	artist oder persona. Standard artist.
`search`	string	Suche über Name, Nickname und Beschreibung.
`offset`	integer	Standard 0.
`limit`	integer	1 bis 100, Standard 24.

GET https://music.boocord.com/api/request/artists.php?kind=persona

get_moods.php

/api/request/get_moods.php

GET

Liefert alle verfügbaren Moods/Kategorien. Keine Pagination, keine Query-Parameter.

GET https://music.boocord.com/api/request/get_moods.php

accounts.php

/api/request/accounts.php

GET

Directory für öffentliche Account-Profile. Es werden nur Profile mit Status public geliefert.

Parameter	Typ	Beschreibung
`search`	string	Suche über Username, Display-Name und Beschreibung.
`offset`	integer	Standard 0.
`limit`	integer	1 bis 100, Standard 24.

GET https://music.boocord.com/api/request/accounts.php?search=tim

account_playlists.php

/api/request/account_playlists.php

GET

Liefert die Playlists eines öffentlichen Account-Profils inklusive Profil-Metadaten.

Parameter	Typ	Beschreibung
`account`	integer	Pflichtfeld. Account-ID eines öffentlichen Profils.
`search`	string	Optionaler Filter über Playlist-Name und Beschreibung.
`offset`	integer	Standard 0.
`limit`	integer	1 bis 100, Standard 24.

GET https://music.boocord.com/api/request/account_playlists.php?account=5

Hinweise

Liefert 400, falls account fehlt oder ungültig ist, und 404, falls der Account kein öffentliches Profil hat.

home_overview_feed.php

/api/request/home_overview_feed.php

GET

Öffentliche Startseiten-Übersicht mit Kennzahlen, neuen Songs, Info-Posts und gemischtem Feed. Mit Login wird der Viewer-Kontext zusätzlich personalisiert.

Parameter	Typ	Beschreibung
`feed_limit`	integer	5 bis 30, Standard 30.
`feed_page`	integer	Seitennummer ab 1.

GET https://music.boocord.com/api/request/home_overview_feed.php?feed_limit=10&feed_page=1

image.php

/api/request/image.php

GET

Sichere Resize-Route für lokale Dateien unterhalb von files/. Der Endpoint skaliert Bilder nach Bounding-Box und liefert gecachte Bilddaten zurück.

Parameter	Typ	Beschreibung
`src`	string	Pflichtfeld. Relativer Pfad unterhalb von files/.
`size`	string	Pflichtfeld. Entweder N oder WxH. Intern auf 16 bis 1024 Pixel pro Seite begrenzt.

GET https://music.boocord.com/api/request/image.php?src=files/covers/skyline.webp&size=512x512

Hinweise

Erlaubt nur lokale Bilder unter files/; externe URLs werden blockiert.
Akzeptierte Quellformate: JPEG, PNG, WEBP, GIF.
Mögliche Fehlercodes: 400, 403, 404, 415, 422.