Wyślij pierwszego e-maila przez API Inbixio w 5 minut

Inbixio zamienia konto e-mail, które już masz, w przejrzyste API HTTPS chronione kluczem. Zamiast otwierać połączenia SMTP z każdej usługi, którą utrzymujesz, Twój kod wysyła jedno żądanie POST, a całą komunikację z serwerem pocztowym przejmuje Inbixio.

Ten poradnik przeprowadzi Cię od nowego konta do dostarczonego e-maila. Potrzebujesz około pięciu minut, konta e-mail obsługującego SMTP (sprawdzi się skrzynka w Google Workspace, Microsoft 365, Zoho albo u dostawcy hostingu) i terminala.

Jak Inbixio wpisuje się w Twój stos

Zanim przejdziemy do kroków, warto zobaczyć, jak to wszystko działa:

1. Twoja aplikacja wysyła do API Inbixio żądanie JSON z kluczem API.
2. Inbixio sprawdza klucz, jego uprawnienia i miesięczny limit Twojego planu, a następnie dodaje wiadomość do kolejki.
3. Twój serwer SMTP (ten, który podłączysz w kroku 2) ją dostarcza. Inbixio loguje się, przełącza połączenie na TLS i przekazuje wiadomość.
4. Twój panel pokazuje, ile e-maili wyszło, jaki odsetek się nie powiódł i ile czasu Twój serwer potrzebował na ich przyjęcie.

Ponieważ wiadomość wychodzi przez Twój własny serwer pocztowy, jest wysyłana z Twojego adresu i domeny, a reputacja, którą zbudowałeś u dostawców skrzynek, pozostaje Twoja.

Krok 1: Załóż konto i wybierz plan

Wejdź na app.inbixio.com/create-account i podaj imię i nazwisko, adres e-mail, nazwę firmy, numer telefonu oraz adres firmy, a następnie ustaw hasło.

Inbixio wyśle link weryfikacyjny na podany adres. Otwórz go, a potem się zaloguj. Przy pierwszym logowaniu poprosimy Cię o wybór planu; płatność jest bezpiecznie obsługiwana przez Stripe. Plany różnią się głównie miesięcznym wolumenem. Jeśli nie wiesz, którego potrzebujesz, przeczytaj, jak oszacować wolumen e-maili.

Krok 2: Podłącz serwer SMTP

W panelu otwórz Email Servers (serwery pocztowe) i wybierz Add Server (dodaj serwer). Zobaczysz cztery pola i dwa przełączniki:

Dwa szczegóły oszczędzą Ci później sporo debugowania:

• Nazwa użytkownika jest też nadawcą. Inbixio wysyła z adresu, którym się logujesz, więc użyj prawdziwej skrzynki we własnej domenie, np. hello@ lub notifications@, a nie prywatnej skrzynki.
• Wielu dostawców wymaga hasła aplikacji. Google na przykład wymaga weryfikacji dwuetapowej i 16-znakowego hasła aplikacji do SMTP. Zwykłe hasło zostanie odrzucone.

Nie wiesz, co wpisać? Ustawienia SMTP w praktyce omawiają hosty, porty i TLS u popularnych dostawców.

Krok 3: Wygeneruj klucz API

Otwórz API Keys (klucze API) i wybierz Create Api Key (utwórz klucz API). Nadaj mu nazwę, która mówi, gdzie będzie używany, na przykład production-backend lub staging-signup-service, a następnie ustaw:

• Server Access (dostęp do serwera): All Server (wszystkie serwery) wysyła przez pierwszy podłączony serwer pocztowy. Selected Server (wybrany serwer) przypina klucz do jednego serwera. Jeśli masz więcej niż jeden adres nadawcy, daj każdej usłudze klucz przypięty do jej serwera; w ten sposób decydujesz, z którego adresu wysyła.
• Permissions (uprawnienia): zaznacz Send (wysyłanie), aby klucz mógł wysyłać e-maile. Nadawaj kluczowi tylko te uprawnienia, których potrzebuje.

Wybierz Generate API Key (wygeneruj klucz API), a następnie skopiuj klucz. Klucze Inbixio zaczynają się od ibx_. Przechowuj go jak hasło: w menedżerze sekretów lub w zmiennej środowiskowej, nigdy w kodzie frontendu ani w publicznym repozytorium. Bezpieczeństwo kluczy API omawia rotację i zakres uprawnień bardziej szczegółowo.

Krok 4: Wyślij pierwszego e-maila

Wyeksportuj klucz, a następnie wyślij żądanie przez curl:

export INBIXIO_API_KEY="ibx_your_key_here"

curl -X POST https://backend.inbixio.com/api/send-email/ \
  -H "X-API-Key: $INBIXIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "you@example.com",
    "subject": "Hello from Inbixio",
    "message": "<h1>It works!</h1><p>My first email sent through the Inbixio API.</p>"
  }'

Udane żądanie zwraca HTTP 200:

{ "message": "Email queued successfully." }

Sprawdź skrzynkę. E-mail przychodzi z adresu, którego użyłeś jako nazwy użytkownika SMTP.

Zachowaj końcowy ukośnik. Endpoint to /api/send-email/. Bez końcowego / serwer odpowiada przekierowaniem, a wiele klientów HTTP nie wysyła ponownie treści żądania po przekierowaniu.

Treść żądania ma trzy wymagane pola:

Krok 5: Potwierdź dostarczenie w panelu

„Queued” oznacza, że Inbixio przyjęło żądanie i rozpoczęło dostarczanie w tle. Dostarczenie przez SMTP następuje chwilę później, a wyniki sumują się w Twoim Dashboard (panel):

• Email Sent (wysłane e-maile) liczy udane wysyłki z ostatnich 7 dni.
• Failed Deliveries (nieudane dostarczenia) pokazuje odsetek e-maili, które Twój serwer SMTP odrzucił w tych samych 7 dniach.
• Avg Latency (średnie opóźnienie) pokazuje, ile czasu Twój serwer SMTP potrzebuje na przyjęcie wiadomości.
• Tabela logs (logi) zawiera każde wywołanie API z identyfikatorem zdarzenia, endpointem, kodem statusu i czasem odpowiedzi.

Jeśli testowy e-mail nie dociera, a odsetek błędów rośnie, przyczyna prawie zawsze leży w ustawieniach serwera: błędne hasło, dostawca wymagający hasła aplikacji albo zły host lub port. Sprawdź je w Email Servers i wyślij kolejny test.

Typowe błędy przy pierwszym żądaniu

O ponawianiu żądań, miesięcznych limitach i obsłudze błędów na produkcji przeczytasz w artykule obsługa błędów i limitów API e-mail.

Co dalej

Masz teraz działający przepływ od Twojego kodu do skrzynek użytkowników. Następne kroki:

• Wysyłaj ze swojego prawdziwego stosu dzięki przykładom w Node.js, Pythonie i cURL.
• Zadbaj, by wiadomości trafiały do skrzynki odbiorczej, korzystając z checklisty SPF, DKIM i DMARC.
• Twórz e-maile, na które czekają użytkownicy: kody OTP i weryfikacyjne oraz resetowanie hasła.