Dokumentacja API
Nayalink udostępnia w pełni typowane REST API. Wszystko, co możesz zrobić w panelu — tworzyć krótkie linki, zarządzać kampaniami i tagami oraz odczytywać analizy kliknięć respektujące prywatność — jest dostępne programowo.
Aby skorzystać z interaktywnej dokumentacji, w której możesz testować żądania w przeglądarce, otwórz interaktywną dokumentację API. Kontraktem czytelnym dla maszyn jest dokument OpenAPI.
Podstawowy adres URL
Wszystkie punkty końcowe są obsługiwane pod adresem https://api.nayalink.co.
Uwierzytelnianie
Uwierzytelniaj się za pomocą klucza API wysyłanego jako token Bearer:
Authorization: Bearer <your-api-key>
Klucze API są dostępne w planach Pro i Business i można je ograniczyć do określonych uprawnień. Zarządzaj nimi w Ustawienia → Tokeny API.
Tworzenie krótkiego linku
Wymagany jest tylko original_url:
curl -X POST https://api.nayalink.co/api/v1/links \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{"original_url": "https://example.com/very/long/url"}'
Odpowiedź zawiera wygenerowany krótki kod oraz pełny krótki adres URL.
Zasoby
- Linki — twórz, aktualizuj i zarządzaj krótkimi linkami: niestandardowe kody, wygasanie, ochrona hasłem i reguły routingu.
- Kampanie — grupuj linki w kampanie i agreguj ich analizy.
- Tagi — porządkuj linki za pomocą oznaczonych kolorami tagów.
- Analytics — odczytuj zagregowane analizy kliknięć respektujące prywatność: wizyty w czasie, kraje, miasta, źródła odesłań, przeglądarki, systemy operacyjne, typy urządzeń, języki i parametry UTM. Żadne adresy IP nie są przechowywane.
- Tokeny API — twórz i unieważniaj klucze API z ograniczonym zakresem.
- Profil — odczytuj i aktualizuj uwierzytelnione konto.
Następne kroki
- Testuj żądania interaktywnie w dokumentacji API.
- Nowy w Nayalink? Zacznij od wprowadzenia.