Przejdź do głównej treści
Ten przewodnik przeprowadzi Cię od zera do subskrybenta dodanego do jednego z Twoich tematów, korzystając z Railmail Public API.

​
Wymagania wstępne

Zanim zaczniesz, potrzebujesz:
  • Projektu Railmail z kluczem API przypisanym do projektu (format rm_live_... lub rm_test_...). Utwórz go w panelu.
  • Narzędzia do wykonywania zapytań HTTP — curl, Postman lub klienta HTTP w Twoim języku.
Podczas integracji używaj klucza rm_test_..., aby nie ruszać danych produkcyjnych.

​
Dodaj subskrybenta do tematu

1

Ustaw klucz API

Zapisz klucz w zmiennej środowiskowej, aby nie wklejać go do każdego zapytania.
export RAILMAIL_API_KEY="rm_test_twoj_klucz"
2

Sprawdź klucze tematów

Wylistuj tematy w swoim projekcie i zanotuj topicKey, do którego chcesz zapisać użytkowników.
curl https://api.railmail.app/api/v1/topics \
  -H "X-API-Key: $RAILMAIL_API_KEY"
3

Utwórz subskrybenta i zapisz go

Utwórz subskrybenta i zapisz go do tematu w jednym zapytaniu, podając topicKeys oraz consent.
curl -X POST https://api.railmail.app/api/v1/subscribers \
  -H "X-API-Key: $RAILMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "topicKeys": ["newsletter"],
    "consent": "GRANTED"
  }'
Jeśli temat korzysta z double opt-in, zgoda zostaje utworzona jako PENDING_CONFIRMATION, a użytkownik musi ją potwierdzić przez otrzymaną wiadomość, zanim zostanie uznany za zapisanego.
4

Zweryfikuj

Pobierz subskrybenta, aby potwierdzić zapis.
curl https://api.railmail.app/api/v1/subscribers/user@example.com \
  -H "X-API-Key: $RAILMAIL_API_KEY"

​
Następne kroki

Przeglądaj wszystkie endpointy

Subskrybenci, kampanie, segmenty, automatyzacje i więcej.

Uwierzytelnianie i zakresy

Zrozum, co może dany klucz i jak go zabezpieczyć.
Potrzebujesz pomocy? Napisz na support@railmail.app.