Zgodność API TurboSMS

SMSBAT w pełni obsługuje warstwę kompatybilności z TurboSMS API. Umożliwia to migrację istniejących integracji zaprojektowanych dla TurboSMS bezpośrednio do SMSBAT bez konieczności przepisywania struktur wiadomości lub ładunków punktów końcowych.

Obsługujemy wysyłanie wiadomości SMS i Viber (w tym zaawansowane funkcje, takie jak karuzele i ankiety), pobieranie statusów i pobieranie szczegółów wiadomości przy użyciu dokładnie tych samych struktur treści żądania, które już znasz.

Uwierzytelnianie

Jedyną różnicą w stosunku do natywnego API TurboSMS jest mechanizm uwierzytelniania. Podczas gdy TurboSMS używa niestandardowego parametru zapytania „tokenu” lub określonego nagłówka uwierzytelniania, SMSBAT wymaga standardowego Tokenu nośnika.

Musisz podać swój token API SMSBAT w nagłówku „Authorization” dla wszystkich żądań:

KOD_BLOKU_0

Podstawowy adres URL

Wszystkie endpointy powinny być kierowane na bazowy adres URL SMSBAT API:

KOD_BLOKU_1

---

Wyślij pojedynczą wiadomość

Punkt końcowy: POST /api/tsms/message/send

Umożliwia wysyłanie wiadomości SMS i Viber z obsługą dostarczania hybrydowego (Viber z rezerwowym SMS-em). Przetwarza pojedyncze żądanie wysłania i zwraca wyniki dostawy dla każdego odbiorcy.

Kluczowe możliwości

• Parametry elastyczne: Parametry globalne można zastąpić określonymi parametrami SMS/Viber.
• Treść: Obsługuje karuzele Viber, ankiety, załączniki plików i interaktywne przyciski.
• Obsługa błędów: Zwraca HTTP 200 nawet w przypadku błędów (ustrukturyzowane odpowiedzi na błędy). kod_odpowiedzi: 999 ze statusem FATAL_ERROR dla błędów systemowych.
• Błędy odbiorców: Określone błędy odbiorców są zwracane w tablicy response_result. Odbiorcy, którym nie udało się wysłać wiadomości, mają „id_wiadomości: null” i określone kody błędów.

Przykład żądania (wiadomość hybrydowa)

KOD_BLOKU_2

Przykład żądania (karuzela Viber)

KOD_BLOKU_3

Przykład żądania (ankieta Viber)

KOD_BLOKU_4

---

Wyślij wiele wiadomości (wsadowo)

Punkt końcowy: POST /api/tsms/message/sendmulti

Ta metoda umożliwia wysyłanie wielu żądań „wysłania” w jednym żądaniu HTTP, oszczędzając obciążenie połączenia. Wywołanie sendmulti z danymi dla 100 żądań będzie szybsze niż wykonanie 100 indywidualnych żądań send.

Przykład żądania

KOD_BLOKU_5

Przykład odpowiedzi

KOD_BLOKU_6

---

Uzyskaj status wiadomości

Punkt końcowy: POST /api/tsms/message/status

Pobierz statusy dostarczenia wysłanych wiadomości, podając ich message_id.

Przykład żądania

KOD_BLOKU_7

---

Uzyskaj szczegóły wiadomości

Punkt końcowy: POST /api/tsms/message/details

Umożliwia pobieranie szczegółowych informacji o utworzonych wiadomościach, w tym pełnych szczegółów ładunku dla kanałów SMS i Viber, cen i dokładnych znaczników czasu.

Przykład żądania

KOD_BLOKU_8

Przykład odpowiedzi

KOD_BLOKU_9