# Wysyłaj SMS przez API - bez opłat za bramkę SMS

Integracja REST API do wysyłki SMS z telefonu. Niższe koszty niż tradycyjne bramki SMS.

## Co daje Ci integracja przez REST API

### REST API z dokumentacją i Swaggerem

Pełna dokumentacja API dostępna pod /docs/api, interaktywny Swagger UI pod /api/schema/swagger-ui/. Endpoint POST /api/messages/ do wysyłki pojedynczej, bulk endpoint do 1000 SMS w jednym requeście.

### SMS wychodzi z fizycznego telefonu - własny numer nadawcy

Każdy SMS wychodzi z karty SIM zainstalowanej w aplikacji Android. Odbiorcy widzą Twój numer telefonu, nie anonimowy shortcode. Wyższy współczynnik odczytów, większe zaufanie.

### Brak opłat za bramkę - SMS przez operatora komórkowego

Wysyłka odbywa się przez normalną sieć operatora komórkowego, nie przez płatną bramkę SMS. Płacisz tylko za abonament telefoniczny, który już masz.

### Webhooks statusu doręczenia

Po doręczeniu SMS-a platforma wywołuje Twój endpoint HTTP z informacją o statusie: doręczony, nieudany, oczekujący. Możesz reagować w czasie rzeczywistym w swojej aplikacji.

### Bulk API - wyślij do 1000 odbiorców w jednym requeście

Endpoint POST /api/messages/bulk/ przyjmuje listę odbiorców z personalizowaną treścią. Jeden request kolejkuje tysiąc SMS-ów. Idealne do powiadomień, alertów i kampanii.

### Klucze API per aplikacja, rate limiting i logi w panelu

Generujesz osobne klucze API dla każdej integracji. Panel pokazuje logi wysyłek, statusy doręczeń i statystyki per klucz. Rate limiting chroni przed niezamierzonymi masowymi wysyłkami.

## Najczęstsze pytania - SMS API

### Jak wysyłać SMS przez API bez bramki SMS?

Rejestrujesz konto, instalujesz aplikację Android na telefonie z kartą SIM i generujesz klucz API w panelu. Następnie wywołujesz POST /api/messages/ z treścią SMS i numerem odbiorcy. Wiadomość trafia do kolejki i jest wysyłana z karty SIM przez sieć operatora - bez pośrednictwa bramki SMS.

### Czym platforma SMS różni się od tradycyjnych bramek SMS?

Tradycyjna bramka SMS to pośrednik, który pobiera opłatę za każdy SMS plus abonament. Tu SMS wychodzi z fizycznego telefonu z kartą SIM - przez normalną sieć operatora komórkowego, bez pośrednika. Odbiorcy widzą Twój numer, a koszty są ograniczone do abonamentu telefonicznego.

### Ile kosztuje wysyłka SMS przez API?

Płacisz miesięczną opłatę za licencję na korzystanie z platformy. Koszt wysyłki SMS to koszt abonamentu telefonicznego w Twojej sieci - bez dodatkowych opłat za SMS. Przy dużych wolumenach to znacząco mniej niż tradycyjna bramka SMS, która nalicza stawkę za każdą wiadomość.

### Jak zintegrować platformę z własną aplikacją przez REST API?

Dodajesz wywołanie HTTP do swojej aplikacji: POST /api/messages/ z nagłówkiem Authorization zawierającym klucz licencji lub klucz API, oraz body z polami phone i message. Pełna dokumentacja z przykładami dla curl, Python i JavaScript dostępna jest pod /docs/api.

### Czy można używać własnego numeru telefonu jako nadawcy SMS?

Tak, to główna zaleta tego rozwiązania. SMS wychodzi z karty SIM zainstalowanej w aplikacji Android - czyli z numeru, który Ty kontrolujesz. Odbiorcy widzą Twój numer prywatny lub firmowy, nie anonimowy numer bramki. Możesz zainstalować aplikację na dedykowanym telefonie z numerem firmowym.

### Jakie jest rate limiting dla API?

Rate limiting jest skonfigurowany per klucz API w panelu. Aplikacja Android pobiera kolejkę oczekujących SMS-ów co 15 minut i wysyła z odstępem około 10 sekund między wiadomościami. To naturalne ograniczenie wynikające z wysyłki przez sieć operatora. Dla dużych wolumenów zalecamy więcej telefonów z osobnymi kartami SIM.

---

Strona: /pl/branze/api/
Rejestracja: /pl/register
