sink
Zarządzaj skróconymi linkami przez API – twórz, edytuj, analizuj i eksportuj adresy URL bez wysiłku.
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Sink to umiejętność do obsługi skróconych linków za pośrednictwem OpenAPI. Twórz nowe linki z automatycznym lub niestandardowym slugiem, wyszukuj istniejące adresy, edytuj je, usuwaj lub eksportuj całe listy. Narzędzie wspiera także analitykę linków i inteligentne generowanie slugów. Idealne dla osób zarządzających dużą liczbą adresów URL – od marketingowców po deweloperów integrujących skracanie linków w swoje aplikacje.
Jak używać
Skonfiguruj dostęp do API poprzez ustawienie zmiennej środowiskowej NUXT_SITE_TOKEN, która będzie używana jako token Bearer do autentykacji wszystkich żądań.
Aby utworzyć skrócony link, wyślij żądanie POST do /api/link/create z obowiązkowym polem url (długi adres do skrócenia). Opcjonalnie dodaj slug (niestandardową nazwę), komentarz, datę wygaśnięcia jako timestamp Unix, lub przekierowania dla aplikacji iOS i Android.
Jeśli nie podasz slugu, system automatycznie go wygeneruje. Serwer może także automatycznie sprawdzić, czy URL jest bezpieczny, jeśli skonfigurowana jest opcja NUXT_SAFE_BROWSING_DOH.
Aby znaleźć istniejący link, użyj GET /api/link/query?slug=nazwa-slugu – otrzymasz pełne dane linku, w tym oryginalny URL i datę utworzenia.
Do edycji lub usunięcia linków, importu lub eksportu całych list oraz przeglądania analityki, użyj odpowiednich endpointów API opisanych w dokumentacji – każdy wymaga autentykacji tokenem Bearer.
Wszystkie odpowiedzi zawierają identyfikator linku, oryginalny URL, slug, znaczniki czasu oraz wygenerowany skrócony adres w formacie https://twoja-domena/slug.