Jak odeslat SMS z rozhraní LWS API

Procédure

Co je to rozhraní API a proč ho používat?

API je zkratka pro "Application Programming Interface" (rozhraní pro programování aplikací). Jedná se o soubor prostředků, které softwarová aplikace a/nebo platforma používá k zajištění přístupu k některým svým funkcím.

V dnešní době jsou rozhraní API na internetu hojně využívána zejména poskytovateli služeb nebo dat, jako je např. služba SMS.

Díky rozhraním API můžete pomocí vlastního skriptu odeslat SMS okamžitě nebo později.

Jak odeslat SMS pomocí rozhraní LWS API

Odeslání SMS pomocí jednoduchého volání:

Pro rychlé a snadné odeslání SMS stačí odeslat požadavek HTTPS s jeho parametry na následující adresu:

HMS: https://sms.lws.fr/sms/api?action=send-sms&api_key=SMS_API_KEY=&to=DESTINATAIRE&from=SenderID&sms=VOTRE_MESSAGE

Údaje, které mají být nahrazeny, jsou následující:

• SMS_API_KEY: Jedná se o váš klíč API, který je k dispozici v sekci "SMS API" ve vašem SMS prostoru.
• RECIPIENT: Toto je telefonní číslo příjemce v mezinárodním formátu.
• SenderID: Toto je váš identifikátor odesílatele.
• YOUR_MESSAGE: obsah SMS zprávy.

Použití rozhraní PHP API:

SMS můžete odeslat pomocí rozhraní PHP API:

<?php /* Příprava proměnných */ /* URL API */ $gateway_url = "https://sms.lws.fr/sms/api"; /* Akce volaná přes API */ $action = "send-sms"; /* Klíč API */ $apiKey = "Váš klíč API"; /* Číslo, na které bude SMS odeslána * Mezinárodní formát - příklad 33600000000 */ $to = "33600000000"; /* ID odesílatele, které se zobrazí na mobilním telefonu. */ $senderID = "Your SenderID"; /* Kódování verze SMS zprávy, která bude odeslána */ $message = urlencode("This is a test message"); // Příprava datového pole pro požadavek API $data = array('action' => $action, 'api_key' => $apiKey, 'to' => $to, 'from' => $senderID, 'sms' => $message, ); // Odeslání požadavku API prostřednictvím cURL $ch = curl_init($gateway_url); curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $get_data = json_decode($response, true); /* Návrat je zpracován.
 * get_data['code'] získá kód podle úspěchu nebo chyby rozhraní API * get_data['Message'] získá zprávu Success nebo vysvětlení chyby.
 */ if($get_data['code'] === 'ok'){ echo 'SMS byla úspěšně odeslána'; } else { echo 'Error code : '.$get_data['code'].' -- '.$get_data['message']; } ?>

• Váš klíč API: Musí to být klíč API, který jste si vygenerovali na platformě SMS.
• Telefonní číslo příjemce: Jedná se o číslo příjemce SMS zprávy.
• Vaše jméno odesílatele: Toto je vaše ID odesílatele, které lze vytvořit na platformě SMS.
• Vaše zpráva: Zpráva, kterou se chystáte odeslat prostřednictvím SMS.

Možné kódy chyb :

100: Problém s operátorem;
103 : Neplatné telefonní číslo;
105 : Použití zakázaného slova;
106 : Neplatné nebo neověřené ID odesílatele;
107 : Problém při psaní SMS;
112: Číslo na černé listině nebo nedostupné API;

Jak odeslat odloženou SMS z rozhraní LWS API

Odeslání SMS pomocí jednoduchého volání:

https://sms.lws.fr/sms/api?action=send-sms&api_key=SMS_API_KEY=&to=DESTINATAIRE&from=SenderID&sms=VOTRE_MESSAGE&schedule=DATE_HEURE

• SMS_API_KEY: Musí být nahrazen vaším klíčem API.
• DESTINATORY: Musí být nahrazeno číslem příjemce zprávy.
• SenderID: musí být nahrazeno vaším jménem odesílatele.
• YOUR_MESSAGE: musí být nahrazeno vaší zprávou
• DATE_TIME: musí být nahrazeno datem a časem odeslání. Datum a čas můžete převést na stránce Timestamp.

Prezentace funkcí rozhraní LWS API spojených s platformou SMS

Závěr

Nyní si můžete vytvořit vlastní rozhraní API pomocí platformy LWS SMS. Pomocí rozhraní API můžete odeslat SMS okamžitě nebo později. Rozhraní API vám také umožní zjistit, kolik kreditu zbývá na vašem účtu.

Neváhejte se podělit o své komentáře a dotazy!