Integracja API SMS

Bramka SMS pozwala zautomatyzować dystrybucję wiadomości SMS i osadzić usługę w dowolnym projekcie

Spróbować bezpłatnie

Możesz połączyć się z naszą bramką SMS za darmo, aktywacja usługi nie jest wymagana. Wszystkie dane przekazywane do interfejsu API muszą być zakodowane w UTF-8.

Wysyłanie wiadomości API

Komunikaty wysyłane są poprzez ustawienie następujących parametrów:

1.

src_addr

*
Alfa-imię
do wysłania
2.

phone

*
Tablica liczb
(do 100 na żądanie)
3.

message

*
Tekst wiadomości
4.

integration_id

*pole opcjonalne
*Wypełnij podczas korzystania z systemu poleceń

Po pomyślnym wysłaniu systemu partnera partner zwróci tablicę "Info", w którym kluczowym jest komunikat ID w naszym systemie, w którym możesz uzyskać status, a numer telefonu zostanie wysłany, do którego był wiadomość wysłano. W poniższym przykładzie "106" - ID SMS, 380989361131 - numer odbiorcy.

Przykład wysyłania wiadomości do formatu "JSON":

{
    "phone" : ["380989361131"],
    "message" : "test text",
    "src_addr" : "VashZakaz"
}
                

Przykład odpowiedzi na format "JSON":

{
 "success_request": {
    "info": {
        "106": "380989361131"
    }
 }
}
                
Taryfy

Uzyskanie statusu wiadomości

Aby uzyskać statusy wiadomości, musisz przekazać jeden parametr: id_sms – tablica identyfikatorów wiadomości, dla których musisz uzyskać status, limit nie przekracza 100. Po pomyślnym żądaniu, system zwróci tablicę „info”, w której kluczem będzie id wiadomości, ale znaczenie jego statusu.

Zapytanie o status:

{
    "id_sms" : ["106"],
}
                

Przykładowa odpowiedź w:

{
 "success_request": {
    "info": {
        "106": "ENROUTE"
    }
 }
}
                

Statusy

200 – Wniosek został pomyślnie przetworzony. Możliwe statusy wiadomości:

1.

ENROUTE

Wiadomość wysłana
2.

DELIVRD

wiadomość dostarczona
3.

EXPIRED

wygasła, wiadomość nie została dostarczona
4.

UNDELIV

nie można dostarczyć wiadomości
5.

REJECTD

wiadomość odrzucona przez system

Błędy

400

Parametry wejścia walidacji błędów

401

Błąd uwierzytelniania użytkownika.

429

Zbyt wiele żądań na jednostkę czasu

453

Powielanie wiadomości w odstępie krótszym niż 2 minuty

500x

Usługa jest chwilowo niedostępna

Uzyskiwanie listy użytkowników Alfa-imię

Aby uzyskać listę dostępnych nazw Alpha, chcesz poprosić o określony adres URL bez korpusu zapytania za pomocą tylko autoryzowanych informacji o użytkowniku.

Po pomyślnym zapytaniu system zwróci listę aktywnych nazw alfa:

Przykład odpowiedzi

{
 "success_request": {
    "info": [
        "test1",
        "test2"
        ]
    }
}
                    

Uzyskanie równowagi użytkownika

Aby uzyskać saldo, musisz wysłać żądanie do powyższego adresu URL bez treści żądania, używając tylko informacji o autoryzowanym użytkowniku

Po udanej prośbie, system zwróci bilansowy bilans użytkownika, tablicę "Info", gdzie:

money - bilans
currency - waluta konta

Przykład odpowiedzi

{
 "success_request": {
    "info": [
        "money": "8111.1700",
        "currency": "UAH"
        ]
    }
}
                    

Bramka SMPP

ESME

SMSC

MSC

SMS, EMS, WAP, USSD, ets

Bramka ta spełnia wszystkie parametry protokołu SMPP v3.4. Aby przetestować naszą bramę, potrzebujesz skontaktuj się z kierownikiem.

Bramka HTTP

Bramka ta umożliwia wysyłanie żądań HTTP na podany adres usługi za pośrednictwem protokołu HTTP przy użyciu metod GET/POST. Aby przetestować naszą bramkę, musisz skontaktować się z managerem.

Bramka XML

Ta brama umożliwia wysyłanie żądań XML do kodowania UTF-8 do określonego adresu serwisowego za pomocą protokołu HTTP za pomocą metody POST. Aby przetestować naszą bramę, musisz skontaktować się z menedżerem.

Pobierz przykłady.

Tutaj możesz pobrać przykłady skryptów, do pracy z wybraną bramą

Metod JSON
Pojedynczy   pdf
Masowa
Bilans
Statusy
Nazwy alfanumeryczne
TOP