API SMS dla polskich firm — REST, JSON, Bearer token
Wysyłaj SMS-y, MMS-y i wiadomości głosowe programowo. Sześć endpointów, autoryzacja Bearer, webhooki DLR. Pay-as-you-go od 0,10 zł/SMS — bez abonamentu, bez minimum miesięcznego.
Pierwszy SMS w 30 sekund
Załóż konto, odbierz token z panelu po weryfikacji, wyślij curl. Tyle.
Wygeneruj token
Po weryfikacji w panelu klienta klikasz „Wygeneruj token" i kopiujesz Bearer.
Wyślij SMS
Wykonaj jeden POST na /v1/sms z numerem i treścią.
curl -X POST https://api.przypominamy.com/v1/sms \
-H "Authorization: Bearer $PRZYPOMINAMY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+48600123456",
"message": "Cześć! Przypominamy o wizycie jutro o 14:00.",
"from": "FIRMA"
}'Sześć endpointów. To wszystko, czego potrzebujesz.
Bez SOAP-u, bez tysiąca opcji konfiguracyjnych. Pełna specyfikacja w Redoc i openapi.json.
Wyślij SMS
Pojedynczy SMS — nazwa nadawcy, planowanie, flash, idempotency przez idx.
Bulk SMS
Do 10 000 odbiorców z tą samą treścią lub do 100 z indywidualnymi treściami.
Wyślij MMS
Multimedia w SMIL — obraz, audio, video z timingiem. Temat + treść.
Wiadomość głosowa (TTS)
Połączenie z syntezatorem mowy. 4 polscy lektorzy. 1–6 prób.
Weryfikacja numeru (HLR)
Sprawdź status, sieć i kraj numeru przed wysyłką. Tańsze kampanie.
Saldo konta
Aktualny stan portfela w PLN. Monitoruj przed dużymi kampaniami.
Autoryzacja: Bearer token
Każde żądanie wymaga nagłówka Authorization: Bearer <token>. Token uzyskasz w panelu klienta po weryfikacji konta.
curl https://api.przypominamy.com/v1/balance \
-H "Authorization: Bearer pk_live_a1b2c3d4..."- Token wygenerujesz w panelu po manualnej weryfikacji konta (24h).
- Rotuj token, jeśli wycieknie — stary unieważnij w panelu.
- Nie wspieramy Basic Auth ani API key w query string. Tylko Bearer.
- Tokenów nie ograniczamy per-IP — używaj tej samej wartości z dowolnego środowiska.
Webhooki: DLR i SMS przychodzące
Platforma wysyła POST application/json na Twój skonfigurowany URL. Fire-and-forget — odpowiedz HTTP 2xx tak szybko, jak się da.
📥 Raport doręczenia (DLR)
Wysyłany przy każdej zmianie statusu SMS-a. Pole idx pochodzi z Twojego żądania — pozwala skojarzyć raport z encją w Twoim systemie.
{
"event": "delivery_report",
"message_id": "msg_abc123",
"to": "+48600123456",
"status": "delivered",
"sent_at": "2026-05-17T10:30:00.000Z",
"done_at": "2026-05-17T10:30:04.000Z",
"idx": "appointment-12345"
}📨 SMS przychodzący
Dwukierunkowa komunikacja — klient może odpowiedzieć na Twojego SMS-a. Wymaga numeru dwukierunkowego (kontakt z supportem przy rejestracji).
{
"event": "incoming_sms",
"message_id": "in_xyz789",
"from": "+48600123456",
"to": "+48732555000",
"message": "TAK",
"received_at": "2026-05-17T10:32:15.000Z"
}Limity i kody błędów
API używa standardowych kodów HTTP. Wszystkie błędy zwracają JSON: {"error":{"code":XXX,"message":"..."}}.
Rate limit
Domyślny limit per token. Po przekroczeniu HTTP 429 z nagłówkiem Retry-After.
Wyższe limity dostępne — napisz na [email protected].
| Kod | Znaczenie |
|---|---|
| 400 | Nieprawidłowy JSON w żądaniu |
| 401 | Brak lub nieprawidłowy token Bearer |
| 402 | Niewystarczające środki na koncie |
| 403 | Brak dostępu do tego endpointu |
| 422 | Błąd walidacji — np. nieprawidłowy numer, pusta treść |
| 429 | Przekroczono rate limit |
| 502 | Błąd dostawcy SMS (upstream) |
| 504 | Timeout dostawcy SMS (10s) |
Cennik API: pay-as-you-go
API dostępne we wszystkich planach. Płacisz tylko za wysłane wiadomości — bez abonamentu i bez minimum miesięcznego.
- Wszystkie endpointy API
- Webhooki DLR + incoming
- Rate limit 100 req/min
- Wsparcie email
- Wszystko ze Startera
- Niższa cena za SMS
- Priorytetowe wsparcie
- Wyższe limity na życzenie
- Dedykowane numery
- SLA i custom rate limits
- Faktura zbiorcza
- Dedykowany opiekun
Ceny dotyczą SMS-ów wysyłanych do Polski. MMS i wiadomości głosowe wycenione osobno — pełen cennik dostępny po zalogowaniu do panelu. Wysyłka zagraniczna w 30+ krajach po stawkach indywidualnych.
Dlaczego weryfikacja 24h?
Nie mamy sandboxa ani instant tokena. Każde konto przechodzi przez ręczną weryfikację. To celowy wybór, nie ograniczenie techniczne.
Antyfraud
Anonimowy sandbox = łatwe nadużycia — phishing, spam, oszustwa SMS-em. Manualna weryfikacja eliminuje ten ruch zanim trafi do sieci operatorów.
Reputacja nadawcy
Operatorzy filtrują numery, z których wychodzi spam. Weryfikujemy zgłoszenia, więc Twoje SMS-y dostarczają się z dobrą reputacją — wyższy delivery rate niż na anonimowych bramkach.
Ludzkie wsparcie
Przy weryfikacji rozmawiamy z Tobą o use case'ie i pomagamy dobrać sender ID, encoding, częstotliwość wysyłek. Nie tylko aktywujemy konto — pomagamy uruchomić wysyłkę.
SDK i integracje no-code
API jest na tyle proste, że standardowy klient HTTP wystarczy. Dla integratorów no-code mamy gotowe nody do najpopularniejszych platform.
Najczęstsze pytania o API
Jak zdobyć token API?
Załóż konto na /register. Każde zgłoszenie weryfikujemy ręcznie w ciągu 24 godzin. Po weryfikacji w panelu klienta wygenerujesz Bearer token i ustawisz webhook URL.
Czy macie sandbox lub środowisko testowe?
Nie. Każde konto przechodzi manualną weryfikację (24h) zamiast anonimowego sandboxa. Chroni to reputację numerów nadawczych i jakość ruchu w sieci. Po weryfikacji możesz wysyłać prawdziwe SMS-y od pierwszego doładowania.
Jaki jest limit zapytań?
Domyślnie 100 żądań na minutę per token. Limit można podnieść po kontakcie z supportem. Po przekroczeniu API zwraca HTTP 429 z nagłówkiem Retry-After wskazującym sekundy do następnej próby.
Czym różnicicie się od innych dostawców API SMS?
Jesteśmy nastawieni na małe i średnie firmy: pay-as-you-go od 100 zł, bez abonamentu i minimalnych zobowiązań. Manualna weryfikacja konta w 24h zamiast samodzielnego sandboxa. Polskie wsparcie. Dokumentacja po polsku. Proste 6 endpointów REST zamiast skomplikowanego SOAP czy 30 metodami SDK.
Czy API obsługuje MMS i wiadomości głosowe?
Tak. Endpoint /v1/mms wysyła MMS z markupem SMIL (obraz, video, audio). Endpoint /v1/vms wykonuje połączenie głosowe z syntezatorem mowy TTS — cztery polskie głosy lektorów (ewa, jacek, jan, maja), 1–6 prób połączenia.
Jak skonfigurować webhook URL dla raportów doręczenia (DLR)?
Webhook URL ustawiasz w panelu klienta. Platforma wysyła POST application/json na Twój endpoint z payloadem zawierającym event, message_id, to, status, sent_at, done_at i Twój idx. Możesz też odbierać SMS-y przychodzące, jeśli masz numer dwukierunkowy.
Czy mogę używać własnej nazwy nadawcy (sender ID)?
Tak. Nazwę nadawcy (do 11 znaków) zgłaszasz w panelu i po weryfikacji możesz jej używać w parametrze from. Bez własnego sender ID SMS-y wychodzą z domyślnego nadawcy klienta.
Czy są SDK dla Pythona, Node.js lub innych języków?
Nie oferujemy własnych SDK — API jest na tyle proste, że standardowy klient HTTP (requests w Pythonie, fetch w Node) wystarczy. W dokumentacji Redoc znajdziesz gotowe przykłady curl, Python i Node.js dla każdego endpointu. Dostępne są też integracje no-code: Zapier, Make, n8n.
Zacznij wysyłać przez API jeszcze dziś
Zgłoszenie weryfikujemy w 24h. Po weryfikacji generujesz token w panelu i wysyłasz pierwszego SMS-a w 30 sekund.
Zarejestruj się →Masz pytania? Napisz na [email protected].