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, hasło i nazwę integracji. Hasło jest wymagane w celu logowania do panelu developera – uwierzytelnianie requestów API odbywa się wyłącznie przez tokeny.
POST /api/v1/auth/register curl -X POST https://api.entiway.com/api/v1/auth/register \ -H "Content-Type: application/json" \ -d '{ "email": "[email protected]", "name": "my-integration", "password": "YourPassword123", "password_confirmation": "YourPassword123" }'
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://api.entiway.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 – Wyszukiwarki firm, Monitoringu firm, Zdarzeń i portfela – ale nie mogą zarządzać innymi tokenami. Dzięki temu Twój Master Token pozostaje bezpieczny.
POST /api/v1/tokens curl -X POST https://api.entiway.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://api.entiway.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 na pierwsze zapytanie. Użyj tokenu API, żeby wyszukać firmy spełniające Twoje kryteria - na przykład branżę, lokalizację czy datę rozpoczęcia działalności. Pojedyncze zapytanie zwraca do 20 firm wraz z lekkim, ustrukturyzowanym rekordem każdej z nich – identyfikatorami, nazwą, lokalizacją, główną działalnością i statusem – a także łączną liczbą wszystkich pasujących rekordów w rejestrze. Jeśli wynik jest większy niż 20, warto najpierw zawęzić filtry, zanim przejdziesz do kolejnych stron wyników – koszt zapytania jest stały, niezależnie od liczby zwróconych rekordów, więc precyzyjniejsze kryteria oznaczają mniej zapytań i niższy koszt całkowity.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?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.