Ten przewodnik przeprowadzi Cię przez wszystko co potrzebujesz żeby wykonać pierwsze wywołanie API — od założenia konta po otrzymanie prawdziwych danych o firmach. Cały proces zajmuje około pięciu minut.
Krok 1 — Rejestracja
Utwórz konto podając swój e-mail i nazwę integracji. Hasło nie jest wymagane — uwierzytelnianie odbywa się wyłącznie przez tokeny.
POST /api/v1/auth/register curl -X POST https://alexambros.com/api/v1/auth/register \ -H "Content-Type: application/json" \ -d '{ "email": "you@example.com", "name": "my-integration" }'
W odpowiedzi otrzymasz swój user_ref oraz znacznik expires_at. Sprawdź skrzynkę — jednorazowy token inicjalizacyjny został wysłany na Twój adres e-mail. Wygasa po 24 godzinach.
Krok 2 — Inicjalizacja konta
Użyj tokenu z e-maila żeby wygenerować swój Master Token. To najważniejszy krok — Master Token jest pokazywany tylko raz i nie można go odzyskać. Skopiuj go natychmiast i przechowaj bezpiecznie.
POST /api/v1/auth/init curl -X POST https://alexambros.com/api/v1/auth/init \ -H "Content-Type: application/json" \ -d '{ "token": "your-email-token-here" }'
Odpowiedź zawiera Twój master_token — ciąg znaków zaczynający się od sk_live_. Zapisz go teraz. Nie zobaczysz go ponownie.
Krok 3 — Utwórz token API
Użyj Master Tokenu żeby utworzyć token API dla swojej integracji. Tokeny API mają dostęp do wszystkich endpointów danych — Search, Watchlist, Events, Wallet — ale nie mogą zarządzać innymi tokenami. Dzięki temu Twój Master Token pozostaje bezpieczny.
POST /api/v1/tokens curl -X POST https://alexambros.com/api/v1/tokens \ -H "Authorization: Bearer sk_live_xxxx" \ -H "Content-Type: application/json" \ -d '{ "name": "my-integration" }'
Odpowiedź zawiera Twój token API w polu plaintext — zaczyna się od sk_api_. Ponownie, pokazywany tylko raz. Zapisz go natychmiast. Używaj tego tokenu we wszystkich kolejnych zapytaniach.
Krok 4 — Doładuj wallet
Każda operacja API pobiera kredyty z Twojego walleta. Przed wykonaniem zapytań o dane doładuj swoje saldo. Zobacz stronę Cennik żeby poznać dostępne pakiety i koszty operacji w kredytach.
POST /api/v1/wallet/topup curl -X POST https://alexambros.com/api/v1/wallet/topup \ -H "Authorization: Bearer sk_api_xxxx" \ -H "Content-Type: application/json" \ -d '{ "package_slug": "pack_1000" }'
Otwórz checkout_url z odpowiedzi w przeglądarce żeby sfinalizować płatność przez Paddle. Kredyty są dodawane do salda automatycznie po potwierdzeniu płatności.
Krok 5 — Pierwsze zapytanie
Jesteś gotowy. Użyj tokenu API żeby wyszukać firmy ze zweryfikowanymi danymi kontaktowymi. To pojedyncze zapytanie zwraca do 20 firm spełniających Twoje kryteria — każda z co najmniej jednym zweryfikowanym telefonem, e-mailem lub faksem.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=phone&voivodeship=mazowieckie" \ -H "Authorization: Bearer sk_api_xxxx"
Co dalej?
Teraz gdy masz tokeny i doładowany wallet, poznaj pozostałe przewodniki lub przejdź do API Reference po pełną dokumentację parametrów.