Jak używać API Urlik do tworzenia krótkich linków

Jak używać API Urlik do tworzenia krótkich linków

Jeśli już znasz pulpit nawigacyjny, API Urlik jest szybszą ścieżką do powtarzalnej pracy. Jedno żądanie może stworzyć jeden krótki link, co ma znaczenie, gdy wysyłasz linki z formularza, skryptu lub arkusza kalkulacyjnego z 40 wierszami. Sztuczka polega na tym, aby najpierw utrzymać żądanie proste.

1. Zdobądź swój klucz API i zapoznaj się z podstawowym formatem żądania

Zacznij od znalezienia swojego klucza API Urlik w ustawieniach konta Urlik lub w obszarze dewelopera. Klucz to to, co identyfikuje twoją aplikację, więc trzymaj go z dala od publicznych repozytoriów i udostępnionych zrzutów ekranu. Krótkie linki nie powinny być tworzone na podstawie domysłów.

Format żądania to zazwyczaj zwykły HTTP z autoryzacją w nagłówku. Jedno ważne żądanie tworzenia linku potrzebuje metody, punktu końcowego, nagłówków i ciała z danymi dla nowego krótkiego linku. To wystarczy, aby przetestować API, zanim zbudujesz coś większego.

Pierwsze żądanie powinno być nudne. Nudne jest dobre. Jeśli API akceptuje JSON, wyślij JSON; jeśli oczekuje danych formularza, wyślij dokładnie ten format i nic więcej. Im mniej zmieniasz, tym łatwiejszy staje się pierwszy test.

2. Zidentyfikuj minimalne dane, których Urlik potrzebuje do nowego krótkiego linku

Dla nowego krótkiego linku, docelowy URL jest pierwszym polem do podania. Bez niego API nie ma dokąd wysłać odwiedzającego. Utrzymuj ten URL w całości, w tym protokół, taki jak https://,, ponieważ brakujący protokół często łamie żądanie.

Niektóre konfiguracje pozwalają na użycie aliasu, pola kampanii lub innej niestandardowej etykiety. Używaj ich tylko wtedy, gdy Twój przepływ pracy tego wymaga. Jeśli Twoim celem jest tylko stworzenie jednego krótkiego linku, minimum jest lepsze niż zatłoczony ładunek z sześcioma opcjonalnymi wartościami i jednym błędem.

Myśl w kategoriach jednego linku, jednego celu, jednego przeznaczenia. Zespół sprzedaży detalicznej może stworzyć krótki link do strony produktu. Redaktor newslettera może stworzyć krótki link do strony rejestracji. Ta sama API, różne zastosowanie. Jeśli Twój zespół potrzebuje również markowych ścieżek, przeczytaj przewodnik na niestandardową domeną krótkiego linku najpierw, ponieważ wybór domeny zmienia to, jak krótki link wygląda dla czytelników.

3. Stwórz krótki link z jednego wywołania API

Najprostszy przepływ pracy to jedno wywołanie API, jeden krótki link, jedna odpowiedź. Wyślij żądanie do punktu końcowego create-link z Twojej aplikacji, terminala lub narzędzia testowego. Jeśli żądanie jest ważne, Urlik powinien zwrócić dane dla nowego krótkiego linku zamiast długiej strony błędu.

Sukcesywna odpowiedź często zawiera krótki URL, oryginalne miejsce docelowe oraz identyfikator nowego krótkiego linku. Skopiuj ten identyfikator, jeśli Twoja aplikacja potrzebuje zaktualizować link później. Skopiuj również krótki URL, ponieważ to jest to, co umieścisz w wiadomości, arkuszu lub przycisku.

Nie buduj dziesięciu funkcji wokół API, zanim pierwsze wywołanie nie zadziała. Jeden krótki link wystarczy na pierwszy raz. Jeśli chcesz porównać różne zachowania przekierowań później, artykuł na przekierowania 301 vs 302jest przydatne, ponieważ wybór przekierowania może wpłynąć na to, co użytkownicy i roboty wyszukiwarek doświadczają po kliknięciu w krótki link.

4. Przeczytaj odpowiedź i skopiuj krótki URL do swojej aplikacji lub arkusza

Gdy odpowiedź przyjdzie, poszukaj pola, które zawiera krótki URL. Niektóre API zwracają zagnieżdżony obiekt, inne zwracają płaskie pola. Tak czy inaczej, twoje zadanie jest takie samo: chwyć krótki link i przechowaj go w miejscu, które już wykorzystuje twój przepływ pracy.

Przepływ pracy w arkuszu kalkulacyjnym jest powszechny. Jeden wiersz może zawierać URL docelowy, inny krótki link, a trzeci datę utworzenia. Narzędzie CRM lub wsparcia może przechowywać krótki link w niestandardowym polu. Ten mały krok oszczędza czas później, ponieważ nikt nie chce przeszukiwać dzienników odpowiedzi w poszukiwaniu linku utworzonego trzy dni temu.

Jeśli twój zespół wysyła linki z śledzeniem lub płatnymi miejscami, trzymaj pole linku oddzielnie od pola docelowego. To unika zamieszania, gdy ktoś skopiuje niewłaściwą wartość. Krótki link powinien być oczywisty na pierwszy rzut oka, nawet w prostym arkuszu z 200 wierszami.

5. Obsłuż powszechne błędy API przed ponownym próbą

Brakujące pola to pierwszy problem do sprawdzenia. Jeśli URL docelowy jest nieobecny, API nie może utworzyć krótkiego linku. Jeśli ciało żądania jest źle sformatowane, API może odrzucić całe wywołanie, zanim nawet sprawdzi URL.

Nieprawidłowe adresy URL to kolejna powszechna przyczyna błędów. Jedna zbędna spacja, jeden brakujący protokół, jeden uszkodzony znak w ciągu zapytania, a żądanie krótkiego linku może się nie powieść. Najpierw napraw dane wejściowe. Powtórz próbę dopiero po upewnieniu się, że docelowy adres URL jest prawidłowy.

Duplikaty niestandardowych aliasów mogą również powodować konflikt. Jeśli twoja drużyna już użyła tego aliasu, API może odmówić utworzenia nowego krótkiego linku. To nie jest problem serwera. To problem z danymi. Zmień alias lub pozwól Urlikowi przypisać jeden automatycznie, jeśli twój proces roboczy na to pozwala.

Błędy autoryzacji są inne. Jeśli klucz API jest błędny, wygasł lub został wysłany w niewłaściwej nagłówku, żądanie może zostać odrzucone. Sprawdź klucz, sprawdź nazwę nagłówka i sprawdź konto, które posiada klucz. Jeśli żądanie kończy się wynikiem podobnym do 401, ponowne wysyłanie tego samego żądania dziesięć razy nie pomoże.

Jedna praktyczna zasada pomaga tutaj: napraw żądanie, gdy błąd wskazuje na twoje dane wejściowe, powtórz próbę tylko wtedy, gdy błąd wydaje się tymczasowy. To brzmi prosto, ale oszczędza czas we wtorkowe poranki.

6. Twórz linki masowo z powtarzalnymi danymi wejściowymi

Tworzenie masowe to po prostu to samo żądanie krótkiego linku powtarzane w całej liście. Skrypt może odczytywać wiersze z pliku, wysyłać jedno wywołanie API na wiersz i zapisywać każdy zwrócony krótki link obok oryginalnego celu. Wzór pozostaje ten sam. Dane wejściowe się zmieniają.

To jest miejsce, w którym API staje się przydatne dla zespołów z 20, 50 lub 500 linkami do wygenerowania. Zespół treści może przygotować linki do każdego artykułu w miesięcznym kalendarzu. Zespół sprzedaży może tworzyć krótkie linki dla każdego przedstawiciela handlowego. Sklep może tworzyć krótkie linki do każdej strony produktu w sezonowym katalogu. Nikt nie chce klikać przez pulpit nawigacyjny tyle razy.

Utrzymuj swoje dane źródłowe w czystości przed uruchomieniem. Jedna kolumna na docelowy URL. Jedna kolumna na alias, jeśli to konieczne. Jedna kolumna na notatki kampanijne, jeśli twój proces ich używa. Następnie przejdź przez listę. Jeśli twój przepływ pracy również potrzebuje wariacji na poziomie linku do testowania, post na testowaniem A/B linków dobrze pasuje, ponieważ masowe tworzenie i testowanie często odbywa się razem.

Praca masowa to wciąż praca dokładna. Zła linia może stworzyć zły krótki link, a zły krótki link szybko się rozprzestrzenia, gdy zostanie wklejony do kampanii lub arkusza. Sprawdź pierwsze 3 wiersze przed uruchomieniem pełnej listy. Ta mała przerwa unika długiego czyszczenia później.

7. Zweryfikuj, czy link działa po utworzeniu

Po utworzeniu otwórz krótki link i potwierdź, że prowadzi do zamierzonej strony. Zrób to raz, zanim wyślesz link do kogokolwiek innego. Link, który prowadzi do niewłaściwej strony, może zmarnować kampanię, a nikt nie chce tego wyjaśniać po uruchomieniu.

Sprawdź adres URL docelowy w pasku adresu przeglądarki lub za pomocą narzędzia do sprawdzania przekierowań. Upewnij się, że strona się ładuje, protokół jest poprawny, a ścieżka jest taka, jak oczekiwałeś. Jeśli strona zawiera logowanie lub zasób z ograniczonym dostępem, potwierdź, że krótki link nadal prowadzi do właściwego punktu wejścia. W przypadku linków z kontrolą dostępu, artykuł na Linków chronionych hasłem może pomóc, jeśli Twój proces roboczy wymaga dodatkowego zabezpieczenia przed tym, jak odwiedzający mogą zobaczyć cel.

Jeszcze jedna szybka kontrola ma znaczenie dla zespołów, które udostępniają linki publicznie: krótki link powinien działać na komputerach stacjonarnych i urządzeniach mobilnych. Przetestuj oba, jeśli strona docelowa zachowuje się inaczej na mniejszych ekranach. Link, który działa dobrze na laptopie, ale nie działa na telefonie, nadal jest uszkodzonym linkiem.

8. Zdecyduj, kiedy użyć API zamiast pulpitu nawigacyjnego

Użyj pulpitu nawigacyjnego, gdy potrzebujesz jednorazowej pracy i możesz wpisać adres docelowy ręcznie. Użyj API, gdy inny system już zna adres URL docelowy lub gdy Twój zespół potrzebuje, aby krótki link został utworzony w formularzu, aplikacji lub zaplanowanej pracy. To rozróżnienie oszczędza dużo pracy.

API ma sens również wtedy, gdy tworzenie linków musi odbywać się w tym samym momencie co inne zdarzenie. Rejestracja może wygenerować krótki link dla nowego konta. Narzędzie sprzedażowe może stworzyć krótki link po oznaczeniu transakcji jako gotowej. Zadanie wsadowe może stworzyć 100 krótkich linków przed rozpoczęciem webinaru. Panel sterowania może to zrobić, ale API może to zrobić bez czekania na osobę, która skopiuje i wklei.

To powiedziawszy, nie każdy zespół powinien zaczynać od kodu. Jeśli trzy osoby tworzą linki raz w tygodniu, panel sterowania może być wystarczający. Jeśli jeden system tworzy linki co godzinę, API jest lepszym rozwiązaniem. Różnica nie jest abstrakcyjna. To liczba kliknięć zaoszczędzonych każdego dnia.

Jeśli twoja konfiguracja później rozwinie się w linki polecające, promocje partnerów lub kierowanie kampanią, API nadal pozostaje w użyciu. Możesz dodać te pola w miarę jak twój proces się rozwija. Dla czytelników porównujących opcje funkcji w całym produkcie, główna strona pod urlik.app jest najszybszym sposobem na zapoznanie się z aktualną dokumentacją Urlik i powiązanymi przewodnikami.

Jedna ostatnia praktyczna uwaga: przechowuj zwrócony krótki link tam, gdzie twój zespół rzeczywiście go użyje. Krótki link ukryty w dzienniku testów nikomu nie pomoże. Krótki link w arkuszu, aplikacji lub przepływie pracy spełnia swoje zadanie już pierwszego dnia.