EnglishWyślij swoją pierwszą wiadomość w popołudnie
Prosty interfejs API REST do wysyłania, śledzenia i odbierania SMS-ów — uwierzytelnianie tokenów, webhook w czasie rzeczywistym i pakiety SDK, bez konieczności uczenia się niczego egzotycznego.
Trzy ruchy i zacznij dostarczać
Każda integracja to ten sam krótki cykl — uwierzytelnianie, wysyłanie, a następnie śledzenie.
Wysyłaj swój klucz dostępu jako nagłówek tokenu z typem zawartości: application/json przy każdym żądaniu.
Opublikuj a od, do i treść. Odpowiedź natychmiast pojawia się z identyfikatorem msgid i kodem błędu.
WYSŁAMY lub OTRZYMAMY raport o stanie na adres URL wywołania zwrotnego w momencie, gdy wiadomość osiągnie swój ostateczny stan.
Jedna prośba, w języku, którego już używasz
Opublikuj swojego nadawcę, odbiorcę i treść za pomocą nagłówka Tokena. Odpowiedź pojawia się w momencie, gdy ją zaakceptujemy.
01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02 -H "Token: $SMSLOCAL_TOKEN" \03 -H "Content-Type: application/json" \04 -d '{05 "from": "SMSLOCAL",06 "to": "14155550123",07 "content": "Your code is 481920."08 }'msgstr „9f2a7c10-4b2e-…”
kierunek „mt”
kod błędu 0
Zapisz msgstr — w ten sposób możesz stąd śledzić tę wiadomość.
Przeczytaj wiadomość od góry do dołu
Wszystkie zdarzenia wysyłania, stanu i przychodzące zwracają ten sam kształt — naucz się tego raz.
Identyfikator wiadomości
msgid — wydawany w momencie utworzenia wiadomości. Jest to uchwyt, którego użyjesz do późniejszego sprawdzenia jego stanu.
Nadawca
od — numer telefonu lub identyfikator alfanumeryczny składający się z maksymalnie 11 znaków, w zależności od tego, jaką tożsamość widzą odbiorcy.
Odbiorca
do — numer, pod który ma zostać wysłana wiadomość, łącznie z kodem kraju.
Kodowanie
kodowanie danych — GSM7 mieści 160 znaków na część; przejdź na Unicode, a liczba ta spadnie do 70. Przejdź dalej, a połączy się w dodatkowe płatne części.
Kierunek
kierunek — każda wiadomość ma postać mt (wysłałeś) lub mo (otrzymałeś), w obu przypadkach ten sam kształt.
Kod błędu
kod błędu — zwracany w odpowiedzi na wysłanie i każdym raporcie o stanie. 0 oznacza zaakceptowane; wszystko inne powie dokładnie, co poszło nie tak.
Jeden punkt końcowy, dwa czasowniki
POST do wysłania, GET do sprawdzenia statusu — w obu przypadkach ten sam adres URL i ten sam nagłówek tokenu.
Wysłać
Wyślij wiadomość i natychmiast otrzymaj identyfikator msgid oraz kod błędu.
Powroty msgstr + kod błęduŚcieżka
Wyszukaj wiadomość, którą już wysłałeś, aby sprawdzić jej aktualny status.
Powroty wiadomość + statusRaporty o stanie, w momencie ich wystąpienia
Ustaw adres URL wywołania zwrotnego, a każda dostawa, niepowodzenie i odpowiedź przychodząca będą tam trafiać jako GET lub POST — nie jest wymagane odpytywanie.
Zdobądź klucz API
Rozpocznij integrację w ciągu kilku minut dzięki naszemu REST API.
Dokumentacja programisty — często zadawane pytania
Przy każdym żądaniu przekazuj swój klucz dostępu w nagłówku Tokenu — Token: {accessKey} — wraz z typem treści: application/json.
Każde wysłanie zwraca msgid. Wskaż nam adres URL wywołania zwrotnego, a my POST lub OTRZYMAMY raport o stanie w momencie, gdy wiadomość osiągnie swój ostateczny stan — zawiera poddatę, datę wykonania i wynikowy kod stanu.
mt (telefon zakończony) to wiadomość, którą wysłałeś; mo (pochodzące z telefonu komórkowego) to odpowiedź, którą otrzymałeś. Obydwa używają tego samego kształtu obiektu wiadomości.
Dostarczenie jest ponawiane zgodnie z zasadami ponawiania — nic nie jest po cichu odrzucane, ale punkt końcowy, który nigdy nie potwierdzi, będzie nadal otrzymywać ponawianie prób.
160 znaków w kodowaniu GSM7 lub 70 w Unicode. Po przekroczeniu limitu wiadomość zostanie złożona w wiele części, z których każda będzie rozliczana osobno.