Poznaj nasze SMS API, zobacz przykłady kodu i zaprogramuj wysyłkę wiadomości SMS w dowolnym systemie lub aplikacji.
SMS API
Przykłady kodu SMS API
PHP
C#
Bash
Python
JavaScript
Java
GO
Pojedyncza wysyłka
Masowa wysyłka
Sprawdzenie stanu numeru (HLR)
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\Feature\Sms\Bag\SendSmsBag;
use Smsapi\Client\Feature\Sms\Data\Sms;
use Smsapi\Client\Curl\SmsapiHttpClient;
/** @var Sms $sms */
$sms = (new SmsapiHttpClient())
->smsapiPlService('%SMSAPI_ACCESS_TOKEN%')
->smsFeature()
->sendSms(SendSmsBag::withMessage('48500000000', 'SMSAPI says hi!'));
var_dump($sms);
Funkcje SMS API
Pojedynczy SMS
Wyślij pojedynczą wiadomość SMS za pomocą API
Czytaj więcej
Masowa wysyłka SMS
Wyślij wiadomości SMS do wielu odbiorców jednocześnie
Czytaj więcej
Raporty doręczenia wiadomości
Obsłuż informację o doręczeniu wysłanej wiadomości
Czytaj więcej
Odbiór SMS
Zdecyduj, co zrobić z SMS-em, który został wysłany pod wykupiony w SMSAPI numer
Czytaj więcej
Sprawdź stan numeru
Sprawdź, czy Twoja baza numerów jest aktualna za pomocą listy HLR
Czytaj więcej
Autentykacja SMS
Wyślij SMS z kodem bezpieczeństwa, a my za Ciebie sprawdzimy jego poprawność
Czytaj więcej
O SMSAPI
Cześć, to my, SMSAPI! Jak nazwa wskazuje wysyłka wiadomości SMS po API w Polsce i na świecie to nasza codzienność. Rozejrzyj się, sprawdź dokumentację, biblioteki API w różnych językach programowania, zarejestruj się i przetestuj wysyłkę z darmowymi punktami na start.
Pierwsza wysyłka SMS po API w trzech krokach
- Załóż darmowe konto testowe w 2 minuty
- Skonfiguruj dostęp do API w Panelu Klienta
- Przetestuj SMS API używając testowych punktów
Więcej materiałów o API do wysyłki SMS
Partnerzy
Dobrze Ci radzę: zwiększ bezpieczeństwo strony z dwuetapową weryfikacją SMS
Czytaj artykuł
Partnerzy
Dobrze Ci radzę: automatyzacja procesów biznesowych przy pomocy integracji usług
Czytaj artykuł
Case study i wywiady
Powiadomienia SMS: monitoring stron WWW – wywiad z Adamem Blok z Ping.pl
Czytaj artykuł
Wiedza
Jak ustawić automatyczny SMS transakcyjny?
Czytaj artykuł
Wypróbuj za darmo
Zero zobowiązań, darmowe punkty i pełne wsparcie
Zarejestruj się
FAQ (często zadawane pytania)
Jakie metody autoryzacji są wspierane przez SMS API?
Autoryzacja zapytań do REST API odbywa się za pomocą tokenów API generowanych w panelu klienta. Zalecamy stosowanie tokenów o ograniczonych uprawnieniach np. tylko do wysyłki, a także filtrowanie adresów IP, aby ograniczyć potencjalne skutki wycieku klucza. Choć nie zalecamy tej opcji, możesz również autoryzować się za pomocą zdefiniowanych haseł API.
REST API czy SMPP – który protokół wybrać do wysyłki SMS?
Zalecamy użycie REST API, które jest standardem dla większości aplikacji webowych i mobilnych ze względu na łatwość implementacji (JSON/HTTP).
Jak obsługiwane jest kodowanie znaków i długość wiadomości (GSM 7-bit vs Unicode)?
Standardowa wiadomość bez znaków diakrytycznych (GSM 7-bit) mieści 160 znaków. Użycie choć jednego znaku spoza tablicy np. ą, ę, €, ś wymusza kodowanie Unicode (UCS-2), co skraca limit pojedynczej części do 70 znaków. Pamiętaj, że niektóre znaki są też liczone podwójnie (szczegóły w Dokumentacji). Nasze SMS API pozwala na automatyczne usuwanie znaków specjalnych (parametr normalize), co pomaga w optymalizacji kosztów wysyłki.
W jaki sposób można odbierać raporty doręczeń (DLR) w czasie rzeczywistym?
System obsługuje raporty doręczeń poprzez webhooks (callback URL). Po zmianie statusu wiadomości u operatora SMSAPI wysyła żądanie HTTP GET pod adres zdefiniowany w panelu klienta lub w parametrze notify_url podanym podczas zlecenia wysyłki. Pozwala to na asynchroniczną aktualizację statusów bez konieczności odpytywania (polling) API.
Jak zintegrować odbiór wiadomości przychodzących?
Do obsługi wiadomości przychodzących wymagany jest numer wirtualny, Short Code albo numer 2WAY. Po otrzymaniu wiadomości SMSAPI za pomocą żądania Callback przesyła na Twój serwer treść wraz z numerem nadawcy. Otrzymane wiadomości podejrzysz także w panelu klienta.
Czy SMS API wspiera biblioteki i SDK dla popularnych języków programowania?
Tak, dostępne są oficjalne biblioteki klienckie dla PHP, Python, Java, C#, JavaScript (Node.js) oraz Go. Obsługują „out of the box” funkcje, takie jak między innymi wysyłka wiadomości, SMS Authenticator, zarządzenie czarną listą, kontaktami, grupami odbiorców. Dokumentacja zawiera również gotowe snippety dla narzędzia cURL.
Jak uniknąć duplikacji wysyłek?
Aby zapobiec podwójnemu wysłaniu wiadomości, używaj parametru idx. Jest to unikalny identyfikator klienta dla danej wiadomości. Jeśli w ciągu 24 godzin API otrzyma drugie żądanie z tym samym idx, to nie wyśle kolejnego SMS-a. Aby włączyć tę funkcję, dodaj parametr check_idx.
Jakie są limity przepustowości (Rate Limiting) i wydajność API?
Infrastruktura SMSAPI pozwala na procesowanie ponad 6 milionów wiadomości na godzinę. W przypadku standardowych kont REST API narzucamy limit 100 odwołań na sekundę (RPS) per adres IP. Skontaktuj się z nami, jeśli planujesz większe, intensywniejsze wysyłki.
Jak testować integrację bez generowania kosztów i wysyłki realnych SMS?
Do testów służy parametr test=1 w żądaniu API. W tym trybie system weryfikuje poprawność składni zapytania, autoryzację oraz stan punktów, ale nie przekazuje wiadomości do operatora i nie pobiera opłat.