BillionVerify jest teraz dostępny w Vercel Connect. Otwórz vercel.com/connect/billionverify lub wyszukaj „BillionVerify” w sekcji Connect na pulpicie Vercel i jednorazowo dodaj swój klucz API BillionVerify do konektora. Od tego momentu każdy połączony projekt Vercel może w czasie działania weryfikować adresy e-mail: Twój kod prosi Vercel Connect o klucz, gdy go potrzebuje, dzięki czemu klucz nigdy nie znajduje się w zmiennej środowiskowej ani w kodzie źródłowym.
Konektor BillionVerify dla Vercel działa z tym samym REST API, kredytami i historią weryfikacji, z których już korzystasz. Jest odpowiednikiem Vercel naszego konektora Claude: użytkownicy Claude weryfikują adresy, prosząc o to na czacie, a deweloperzy Vercel weryfikują je w formularzach rejestracyjnych, zadaniach w tle i agentach AI wdrażanych w Vercel.
Dlaczego warto używać Vercel Connect do weryfikacji adresów email
Większość zespołów dodaje weryfikację adresów email, wklejając klucz API do zmiennych środowiskowych każdego projektu. Działa to do czasu, aż pojawi się kilka projektów, środowiska podglądowe i produkcyjne oraz kilka osób, które mogą odczytać te zmienne. Rotacja klucza oznacza wtedy konieczność znalezienia każdej jego kopii.
Vercel Connect przenosi klucz w jedno miejsce na poziomie zespołu:
- Jeden klucz, wiele projektów. Przechowujesz klucz API BillionVerify w konektorze tylko raz. Każdy połączony z nim projekt może go używać, a żaden z nich nie przechowuje własnej kopii.
- Ty decydujesz, kto może go używać. Konektor odpowiada na żądania tokenów wyłącznie z projektów i środowisk, które z nim połączysz. Zobacz łączenie projektów w dokumentacji Vercel.
- Żądania są rejestrowane. Każdy konektor ma kartę Observability, która rejestruje żądania tokenów według projektu, środowiska i podmiotu.
- Rotacja wymaga jednej edycji. Utwórz nowy klucz w BillionVerify, zaktualizuj konektor, a każdy połączony projekt automatycznie go pobierze.
W przypadku agentów AI ma to większe znaczenie niż w przypadku klasycznej aplikacji internetowej. Agent, który może wywoływać narzędzia, nie powinien mieć możliwości odczytywania niezaszyfrowanych danych uwierzytelniających ze swojego środowiska. Dzięki Vercel Connect kod agenta żąda klucza w momencie wywołania BillionVerify, a klucz nigdy nie staje się częścią wdrożenia.
Jak znaleźć BillionVerify w Vercel Connect
Istnieją dwa sposoby dotarcia do konektora BillionVerify w Vercel. Oba prowadzą do tej samej konfiguracji.
Z publicznego katalogu Vercel Connect
Otwórz vercel.com/connect/browse i wpisz „billionverify” w polu wyszukiwania albo przejdź bezpośrednio do vercel.com/connect/billionverify. Wpis pokazuje metodę połączenia (klucz API) oraz krótki opis: weryfikuj adresy e-mail pojedynczo, partiami lub poprzez przesłanie pliku zbiorczego.
Z panelu Vercel
Jeśli jesteś już zalogowany w Vercel, otwórz Connect w panelu swojego zespołu, wpisz „billionverify” w polu wyszukiwania i wybierz BillionVerify z sekcji Wszystkie konektory. To najszybsza metoda podczas konfigurowania projektu, który już wdrażasz w Vercel.
Jak dodać konektor BillionVerify do projektu Vercel
Konektor używa klucza API z Twojego konta BillionVerify. Jeśli nie masz jeszcze konta, najpierw zarejestruj się na billionverify.com; darmowy plan zapewnia 20 kredytów za każdy dzień korzystania z konta, maksymalnie 600 miesięcznie, bez karty kredytowej.
Krok 1: Utwórz klucz API BillionVerify
Zaloguj się i otwórz stronę kluczy API w panelu BillionVerify. Utwórz klucz i nadaj mu nazwę wskazującą, gdzie jest używany, na przykład „vercel-production”, aby można go było później rozpoznać w historii użycia.
Krok 2: Skonfiguruj połączenie w Vercel
Kliknij BillionVerify w Vercel Connect, aby otworzyć opcję Add Connection, a następnie wypełnij etap Configure:
- Name. Vercel proponuje losową nazwę, taką jak
chestnut-fence. Zastąp ją czymś rozpoznawalnym, na przykładbillionverify-prod. Wraz z usługą tworzy ona identyfikator konektora używany przez kod:billionverify/billionverify-prod. - UID (opcjonalnie). Pozostaw puste, a Vercel wygeneruje je na podstawie nazwy usługi i konektora.
- Shared API Keys lub Per-User API Keys. Shared przechowuje jeden klucz w konektorze dla wszystkich użytkowników Twojej aplikacji. Per-User prosi każdego użytkownika o podanie własnego klucza BillionVerify podczas autoryzacji. W następnej sekcji wyjaśniono, kiedy wybrać poszczególne opcje.
- Key. Wklej klucz API z kroku 1.
- Scope and Expiration (opcjonalnie). Ustaw datę wygaśnięcia, jeśli Twój zespół regularnie zmienia klucze; w przeciwnym razie pozostaw wartości domyślne.
Kliknij Create Connector, aby go zapisać.
Krok 3: Połącz projekty, które mogą z niego korzystać
Połącz konektor z projektami i środowiskami Vercel, które powinny mieć możliwość weryfikowania adresów e-mail, na przykład ze środowiskami production i preview Twojej aplikacji internetowej, ale nie z wewnętrznym narzędziem, które nie ma powodu wywoływać BillionVerify. Niepołączony projekt otrzyma błąd zamiast klucza.
Wolisz terminal? Użyj Vercel CLI
Ta sama konfiguracja działa za pośrednictwem Vercel CLI. Uruchom ją w projekcie, który będzie korzystać z konektora:
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull pobiera krótkotrwały token programistyczny do pliku .env.local, dzięki czemu getToken działa również podczas uruchamiania aplikacji na własnym komputerze. Ten plik zawiera token Vercel, a nie klucz BillionVerify.
Współdzielone klucze API czy klucze API dla każdego użytkownika?
Wybierz współdzielone klucze API, gdy to Twój produkt wykonuje weryfikację: formularz rejestracyjny odrzucający adresy jednorazowe, nocne zadanie oczyszczające nowe leady lub wewnętrzny agent używany przez Twój zespół. Wszystkie weryfikacje korzystają z Twojego konta BillionVerify i Twoich kredytów.
Wybierz klucze API dla każdego użytkownika, gdy tworzysz produkt dla innych osób, które mają własne konta BillionVerify, na przykład dodatek do CRM, narzędzie do cold mailingu lub szablon agenta. Każdy użytkownik dodaje własny klucz podczas autoryzacji, więc jego weryfikacje korzystają z jego własnych kredytów i pojawiają się w jego własnej historii BillionVerify.
Wywołuj BillionVerify z poziomu swojego kodu
Zainstaluj Vercel Connect SDK w swoim projekcie:
npm install @vercel/connect
Następnie pobierz klucz za pomocą getToken i prześlij go w nagłówku BV-API-KEY. Oto handler trasy Next.js, który sprawdza jeden adres za pomocą aktywnego sprawdzenia SMTP:
// app/api/verify-email/route.ts
import { getToken } from '@vercel/connect';
export async function POST(req: Request) {
const { email } = await req.json();
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'app' },
});
const res = await fetch('https://api.billionverify.com/v1/verify/single', {
method: 'POST',
headers: { 'BV-API-KEY': apiKey, 'Content-Type': 'application/json' },
body: JSON.stringify({ email, check_smtp: true }),
});
const body = await res.json();
return Response.json(body.data);
}
Obiekt data w odpowiedzi zawiera status (valid, invalid, catchall, role, disposable lub unknown), is_deliverable, is_disposable, is_catchall, is_role oraz reason. Formularz rejestracji zwykle blokuje nieprawidłowe i jednorazowe adresy, akceptuje prawidłowe, a adresy catch-all i nieznane przepuszcza z oznaczeniem, aby można było obserwować ich zachowanie.
SDK przechowuje klucz w pamięci podręcznej i wykorzystuje go ponownie, więc nie wywołuje Vercel Connect ponownie dla każdego weryfikowanego adresu.
Weryfikacja partii lub całego pliku
Ten sam klucz działa ze wszystkimi endpointami BillionVerify:
POST /v1/verify/singlesprawdza jeden adres, jak wyżej.POST /v1/verify/bulksprawdza do 50 adresów w jednym żądaniu. Wyślij{"emails": [...], "check_smtp": true}.POST /v1/verify/fileprzesyła plik CSV do zadania wykonywanego w tle. Sprawdzaj status za pomocąGET /v1/verify/file/{id}i pobierz wyniki zGET /v1/verify/file/{id}/results.
Popularny schemat na Vercel to zadanie cron, które zbiera nowe kontakty z danego dnia, wysyła je do /v1/verify/bulk w grupach po 50 i zapisuje status z powrotem w bazie danych. Szczegóły żądań i odpowiedzi znajdziesz w dokumentacji API.
Klucze poszczególnych użytkowników w kodzie
W przypadku Per-User API Keys przekaż identyfikator zalogowanego użytkownika jako subject:
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
Jeśli ten użytkownik nie podał jeszcze klucza, SDK zgłosi UserAuthorizationRequiredError. Przechwyć ten błąd i wyświetl w interfejsie krok „Połącz swoje konto BillionVerify”. Pozostałe klasy błędów wymieniono w dokumentacji tokenów Vercel.
Używaj BillionVerify w agentach AI na Vercel
Jeśli tworzysz agenta na Vercel, dodaj mu narzędzie „weryfikuj e-mail”, którego kod wywołuje getToken, a następnie BillionVerify, dokładnie tak jak powyższy handler trasy. Model decyduje, kiedy zweryfikować adres; klucz pozostaje w Vercel Connect i nigdy nie pojawia się w promptcie, wynikach narzędzia ani środowisku agenta.
Ten sam klucz API obsługuje również nasze pozostałe integracje agentów:
- Serwer MCP.
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpuruchamia lokalnie nasz serwer MCP z tymi samymi 11 narzędziami co wersja hostowana. Konfiguracja dla każdego klienta znajduje się w przewodniku MCP. - Umiejętność agenta. Agenci kodujący mogą zainstalować umiejętność BillionVerify za pomocą
npx skills add BillionVerify/billionverify-skill. Więcej informacji znajdziesz w Umiejętnościach agentów.
Jak działają kredyty
Weryfikacja przez konektor Vercel kosztuje tyle samo co weryfikacja w dowolnym innym miejscu w BillionVerify: jeden kredyt za jednoznaczny wynik. Nieznane, jednorazowe i nieprawidłowo sformatowane adresy są bezpłatne, podobnie jak ponowne sprawdzenie tego samego adresu w ciągu 24 godzin. Adresy catch-all są oznaczane jako catch-all, a nie uznawane za prawidłowe, więc to Ty decydujesz, jak je traktować.
Vercel rozlicza własne żądania tokenów osobno, zgodnie z cennikiem Vercel Connect. Ponieważ SDK buforuje klucz, jedno żądanie tokenu zwykle wystarcza do wielu weryfikacji.
BillionVerify jest również dostępny w Claude
Na początku tego miesiąca BillionVerify został dodany do katalogu konektorów Claude. Jeśli Ty lub Twój zespół pracujecie w Claude, możecie połączyć tam BillionVerify ze swoim kontem — klucz API nie jest potrzebny — i poprosić Claude o zweryfikowanie adresu lub oczyszczenie listy zawierającej do 50 pozycji bezpośrednio na czacie. Przeczytaj BillionVerify jest już w katalogu konektorów Claude, aby dowiedzieć się, jak go skonfigurować.
Claude służy do sprawdzania adresów podczas pracy. Konektor Vercel służy do sprawdzania wykonywanych przez własne aplikacje i agentów.
Najczęściej zadawane pytania
Czym jest konektor BillionVerify Vercel?
To wpis BillionVerify w Vercel Connect. Przechowujesz klucz API BillionVerify w konektorze, a połączone z nim projekty Vercel mogą żądać tego klucza w czasie działania, aby wywoływać API weryfikacji adresów e-mail BillionVerify.
Czy nadal muszę umieszczać mój klucz API w zmiennych środowiskowych?
Nie. Klucz znajduje się w konektorze. Twój kod pobiera go za pomocą getToken z @vercel/connect, które automatycznie uwierzytelnia wdrożenie w Vercel Connect.
Czy weryfikacja adresów e-mail przez Vercel kosztuje dodatkowo?
Nie po stronie BillionVerify. Weryfikacje wykorzystują środki na koncie BillionVerify według standardowej stawki. Vercel pobiera opłaty za własne żądania tokenów zgodnie z cennikiem Vercel Connect.
Czy powinienem wybrać Shared API Keys czy Per-User API Keys?
Shared API Keys, gdy Twoja własna aplikacja weryfikuje adresy przy użyciu Twojego konta. Per-User API Keys, gdy tworzysz produkt, którego użytkownicy mają własne konta BillionVerify i powinni płacić za własne weryfikacje.
Czy mogę używać konektora poza wdrożeniem Vercel?
Tak. W przypadku lokalnego programowania vercel env pull zapewnia token deweloperski. W innych środowiskach, takich jak zewnętrzne CI, możesz przekazać token dostępu Vercel do getToken za pomocą opcji vercelToken. Możesz także wywoływać API BillionVerify bezpośrednio za pomocą klucza, bez Vercel Connect.
Czy konektor Vercel działa z hostowanym serwerem MCP?
Hostowany serwer MCP pod adresem mcp.billionverify.com loguje Cię za pomocą OAuth — właśnie tego używa konektor Claude. Konektor Vercel przechowuje klucz API, który działa z REST API, pakietem npm billionverify-mcp oraz umiejętnością agenta.
Dodaj BillionVerify w Vercel Connect
Otwórz vercel.com/connect/billionverify, wklej swój klucz API BillionVerify, połącz projekt i zweryfikuj kolejną rejestrację lub leada, zanim trafi na Twoją listę.