API integracja SMS

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

Wypróbuj za darmo

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

*
Nazwa alfa
do wysłania
2.

phone

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

message

*
Wiadomość tekstowa
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"
    }
 }
}
                

Stany

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

1.

ENROUTE

Wiadomość wysłana
2.

DELIVRD

wiadomość dostarczona
3.

EXPIRED

Wygasł życie, 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 nazw użytkowników alfa

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 - balansować
currency - Waluta konta

Przykład odpowiedzi

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

Gateway 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.

Brama 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.

XML Gateway.

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ą

metoda JSON
Pojedynczy   pdf
Cielsko
Balansować
Stany
Nazwy alfa
TOP