HTTP API - akcja 'sendmessage'

To polecenie HTTP API może być używane do wysyłania wiadomości SMS przez Bramkę SMS. Polecenie może być używane do wysyłania tekstowych wiadomości SMS lub innych typów wiadomości, takich jak binarne wiadomości SMS, loga operatorów, dzwonki, WAP PUSH, itp... Kiedy używasz tego polecenia, musisz użyć nazwy użytkownika i hasła HTTP API, musisz określić numer telefonu odbiorcy oraz treść wiadomości.

Opis

Aby wysłać SMS, użyj następującego formatu URL:

https://127.0.0.1:9508/api?action=sendmessage&username=UUUUU&password=PPPPP&
recipient=NNNNN&messagetype=MMMMM&messagedata=DDDDD

127.0.0.1 to lokalny adres IP, więc zastąp go adresem IP lub nazwą hosta komputera z zainstalowaną Bramką SMS Ozeki. (Uwaga: 127.0.0.1 to lokalny adres pętli zwrotnej, który może być używany, gdy łączysz się z Bramką SMS z tego samego komputera.) 9508 to domyślny port HTTP API Bramki SMS Ozeki. Ten numer portu można zobaczyć i edytować w interfejsie użytkownika Bramki SMS Ozeki 10, klikając przycisk Zaawansowane na pasku narzędzi.

"UUUUU" i "PPPPP" należy zastąpić nazwą użytkownika i hasłem użytkownika utworzonego w bramce SMS.

Zastąp "NNNNN" numerem telefonu, na który chcesz wysłać wiadomość SMS. Możesz użyć lokalnego formatu numeru telefonu, jak również międzynarodowego formatu numeru telefonu (numery telefonów w formacie międzynarodowym zawsze zaczynają się od znaku '+'). Jeśli używany jest międzynarodowy format numeru telefonu, pamiętaj, że musisz zastąpić znak '+' ciągiem '%2B' ze względu na zasady kodowania URL.

Zastąp "MMMMM" typem wiadomości. Typ wiadomości "SMS:TEXT" powinien być używany dla wiadomości tekstowych.

Dane wiadomości zawierają treść, którą chcesz wysłać. Umieść dane wiadomości zamiast "DDDDD". Dane wiadomości powinny być zakodowane w UTF-8 i powinny być zakodowane w URL.

Do żądania można również dodać inne parametry.
Aby zapoznać się z pełną listą dostępnych parametrów, zobacz tabelę 'Parametry żądania' poniżej:

Przykładowe żądanie URL

https://127.0.0.1:9508/api?action=sendmessage&username=admin&password=abc123&
recipient=06203105366&messagetype=SMS:TEXT&messagedata=Hello+World

Przykładowa odpowiedź

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 246

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE smsapi PUBLIC "-//OZEKI//DTD XML 1.0//EN" "http://www.ozekisms.com/DTD/smsapi.xml">
<response>
   <action>sendmessage</action>
   <data>
      <acceptreport>
         <statuscode>0</statuscode>
         <statusmessage>Wiadomość zaakceptowana do dostarczenia</statusmessage>
         <messageid>ERFAV23D</messageid>
         <recipient>06203105366</recipient>
      </acceptreport>
   </data>
</response>

<acceptreport>
   <statuscode>0</statuscode>
   <statusmessage>Wiadomość zaakceptowana
   do dostarczenia</statusmessage>
   <messageid>ERFAV23D</messageid>
   <recipient>06203105366</recipient>
</acceptreport>

Podsumowanie

Ten artykuł dotyczył akcji ‘sendmessage’ w HTTP API. Za pomocą tej akcji możesz wysyłać wiadomości SMS tekstowe oraz wiele innych typów wiadomości do dowolnych odbiorców przez Bramkę SMS Ozeki. Zobaczyłeś przykładowe odpowiedzi oraz więcej żądań HTTP z opisami, dopuszczalnymi wartościami i przykładami.

Jeśli chcesz dowiedzieć się więcej o statusie dostarczenia swoich wiadomości, kliknij stronę o statusach dostarczenia SMS. Jeśli potrzebujesz szablonu URL, odwiedź odpowiednią stronę.

Jeśli chcesz użyć tego rozwiązania w praktyce, pobierz Bramkę SMS Ozeki i zacznij korzystać już teraz!