Endpointy API

Mediaverse wystawia niewielką liczbę adminowych endpointów HTTP. Są przeznaczone do obsługi UI admina, ale można ich używać do skryptów, jeśli potrzebujesz.

Wszystkie endpointy wymagają prawidłowej sesji admina (cookie albo tokenu Authorization: Bearer … z /api/oauth/token).

Wykrywanie użycia mediów

Te endpointy pomagają zapobiec przypadkowemu usunięciu mediów, które są w użyciu.

Metoda	Ścieżka	Cel
GET	/api/p2lab-mediaverse/get-media-in-products-usage/{mediaId}	Zwraca produkty, które używają danego medium jako wideo. Odpowiedź: { "success": true, "products": [...] }.
GET	/api/p2lab-mediaverse/get-media-in-cms-usage/{mediaId}	Zwraca strony CMS, których bloki referują dane medium. Odpowiedź: { "success": true, "cmsPages": [...] } (ograniczone do 25 stron).

Powiadomienia

Plugin pokazuje dwa powiadomienia w panelu admina, konfigurowane server-side. Dwa endpointy wspierają UI:

Metoda	Ścieżka	Cel
GET	/api/p2lab-mediaverse/notifications	Zwraca bieżący stan powiadomień pluginu. Odpowiedź: { "incentiveToRating": bool, "notSubscribedFeatures": bool }.
POST	/api/p2lab-mediaverse/notification/hide	Body: { "name": "incentiveToRating" } albo { "name": "notSubscribedFeatures" }. Ukrywa nazwane powiadomienie. Odpowiedź: { "success": true }.

Semantyka powiadomień:

• incentiveToRating — true przez pierwsze 21 dni po zainstalowaniu pluginu; zachęca admina do oceny pluginu w Shopware Store. Można ręcznie ukryć.
• notSubscribedFeatures — true domyślnie; informuje admina, że niektóre funkcje wymagają subskrypcji, która nie jest aktywna. Można ręcznie ukryć.

Format błędu

Wszystkie odpowiedzi błędów stosują standardowy format admin Shopware:

{
    "errors": [
        {
            "code": "...",
            "detail": "Human-readable error",
            "status": "400"
        }
    ]
}

Limity zapytań

Nie ma limitów specyficznych dla Mediaverse — endpointy dziedziczą konfigurację rate-limit Shopware. Dla skryptów o dużym wolumenie batchuj żądania przez standardowe Sync API, jeśli to możliwe.

Powiązane

• Import CSV
• Niestandardowe pola product media