PiotrMusic
API v1← Twój katalog

DLA CIEBIE I TWOICH SKRYPTÓW

Jedna biblioteka.
Trzy sposoby pracy.

Strona, API i terminal operują na tych samych wydaniach i plikach.
Zaplanowanie migracji nie zapisuje niczego w FreshTunes.

PRAWDZIWE ŻĄDANIA DO TEJ INSTANCJI

Wypróbuj API.

Wymaga Twojej sesji lub tokenu
GET/api/v1/releases

Przeglądaj i wyszukuj wydania

To działająca instancja. Wysłane zmiany zapiszą się w Twoim katalogu.

Odpowiedź
Wybierz endpoint i wyślij żądanie.

CZYTELNIE TAKŻE W TERMINALU

Muzyka bez klikania.

Twój katalog

pmusic releases list
pmusic releases add --title "Bałtyk" --artist KRAM
pmusic releases show ID
pmusic releases update ID --version 1 --title "Świt"

Oryginalne pliki

pmusic assets add cover.jpg --kind artwork
pmusic assets add master.wav --kind audio
pmusic releases add --file wydanie.json
pmusic assets show ID

Podgląd przed migracją

pmusic freshtunes status --verify
pmusic freshtunes pull
pmusic sync plan ID_WYDANIA
pmusic sync apply ID_PODGLĄDU

Skrypty i dokumentacja

pmusic --json releases list
pmusic --json doctor
pmusic sync --help
pmusic openapi --output openapi.json

ID podglądu zwraca sync plan. Nieaktualny podgląd jest odrzucany. Migracja tworzy lub aktualizuje szkic; nie wysyła go do dystrybucji.

Jeden format błędów

{
  "error": {
    "code": "VERSION_CONFLICT",
    "message": "Wydanie zostało zmienione…",
    "details": {"current_version": 2}
  }
}

Przewidywalne odpowiedzi

201 · utworzono lokalne wydanie lub plik

401 · potrzebna sesja Piotr Music lub FreshTunes

409 · konflikt, stary podgląd lub operacja w toku

413 / 422 · limit pliku lub dane do poprawy

502 · zewnętrzna usługa nie potwierdziła wyniku

CLI zwraca niezerowy status i ten sam kod błędu.