Integracja API do wysyłania SMS-ów
Klub SMS oferuje połączenie interfejsu (bramka SMS) do automatycznego wysyłania SMS-ów. Istnieje możliwość integracji usługi z dowolnym projektem.
Połączenie z bramką SMS serwisu naszej firmy jest bezpłatne bez aktywacji usługi. Jedynym warunkiem jest to, że kodowanie danych, które mają zostać przekazane do interfejsu API, musi być UTF-8.
JSON: specyfikacja API
*zalecana
Do komunikacji z serwerem przeglądarka potrzebuje metody POST. Żądania wysyłane są na żądany adres za pośrednictwem protokołu HTTP, do tego celu wykorzystywany jest standardowy format tekstowy JSON (JavaScript Object Notation).
Prawo dostępu do zasobów użytkownika realizowane jest poprzez protokół autoryzacji OAuth 2.0. Aby uwierzytelnić żądania, potrzebujesz tokena, aby uzyskać, który trafia na Twoje konto osobiste w sekcji Profil. Wybierz token i wklej go w nagłówku żądania: 'Autoryzacja: Na okaziciela twój_token'.
Uwaga! Limit liczby żądań (dostęp API) wynosi do 9 sztuk/s od każdego użytkownika.
Wysyłanie SMS-ów przez API
Adres internetowy usługi: https://im.smsclub.mobi/sms/send
Aby wysyłać powiadomienia SMS przez API, musisz podać następujące dane:
src_addr
phone
(nie więcej niż 100 w jednym żądaniu)
message
integration_id
Pomyślne wysłanie powiadomienia do systemu partnerskiego potwierdzane jest zwróceniem tablicy, gdzie „info” jest kluczem, id powiadomienia w systemie Klubu SMS. Zgodnie z tym identyfikatorem przypisywany jest status, w którym wartością jest numer telefonu abonenta, do którego została wysłana wiadomość SMS. Zobacz przykład: "107" - id sms, 380989371132 - numer klienta.
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"
}
}
}
Jak uzyskać status SMS
Adres internetowy: https://im.smsclub.mobi/sms/status
id_sms - unikalny identyfikator SMS, którego przesłanie powoduje odebranie statusu. Możesz również wysłać tablicę identyfikatorów powiadomień, nieprzekraczającą 100 identyfikatorów. Po udanym żądaniu program zwraca tablicę informacyjną, gdzie id to klucz SMS, wartość to status.
Przykład:
{
"id_sms" : ["107"],
}
Możliwa odpowiedź:
{
"success_request": {
"info": {
"107": "ENROUTE"
}
}
}
Opcje statusu
200 – Powodzenie! Żądanie zakończone. Możliwe statusy powiadomień:
ENROUTE
DELIVRD
EXPIRED
UNDELIV
REJECTD
Błędy
400
401
429
453
500x
Uzyskiwanie alfanumerycznych nazw subskrybentów
Wsparcie adres internetowy: https://im.smsclub.mobi/sms/originator
Możesz uzyskać aktywne nazwy alfa, wysyłając zapytanie do powyższego adresu URL. Wystarczy przesłać dostępne dane, które nie zawierają treści tekstowych.
Jeśli żądanie zostanie zakończone, program zwróci listę wolnych nazw alfa:
Opinia na temat pomyślnego wniosku
{
"success_request": {
"info": [
"test1",
"test2"
]
}
}
Jak uzyskać równowagę użytkownika
Wsparcie adres internetowy: https://im.smsclub.mobi/sms/balance
Wyślij prośbę na powyższy adres URL. Treść tekstowa w danych autoryzowanego użytkownika nie musi być określana.
Jeśli żądanie zostanie zakończone, program zwróci tablicę „info”, w której:
money - bilans
currency - waluta
Opinia na temat pomyślnego wniosku
{
"success_request": {
"info": [
"money": "8121.1800",
"currency": "UAH"
]
}
}
Bramka SMPP
ESME
SMSC
MSC
SMS, EMS, WAP, USSD, ets
Router sprzętowy jest zgodny z protokołem SMPP v3.4. Aby przetestować router sprzętowy, skontaktuj się z naszym specjalistą.
Bramka HTTP
Brama sieciowa wysyła żądania HTTP do przypisanego adresu URL usługi. Do wysyłania używany jest protokół HTTP oraz metody GET/POST. Aby przetestować router, skontaktuj się z naszymi ekspertami.
Bramka XML
Router sprzętowy jest przeznaczony do wysyłania żądań XML na wyznaczony adres. Żądania zakodowane w UTF-8 są wysyłane przez HTTP metodą POST. Aby sprawdzić bramkę sieciową, skontaktuj się z naszym specjalistą.
Ładowanie próbek
Wybierz bramę i pobierz przykładowe skrypty.
| Metod | JSON | 1С |
|---|---|---|
| Pojedynczy |
|
|
| Masowa |
|
|
| Bilans |
|
|
| Statusy |
|
|
| Nazwy alfanumeryczne |
|
