HotSender API | Masowe wiadomości SMS

POST Wysyłka masowych wiadomości SMS

ADRES

https://hotsender.pl/api/v1/sms/multi

OPIS

Wysyła multi wiadomości dla wybranych numerów telefonu oraz pod określoną nazwą nadawcy.

PARAMETRY

Parametr	Opis	Typ	Wymagany
from	Nazwa nadawcy. Maksymalnie 12 znaków	String	TAK
to	Numery telefonów na które zostaną wysłane wiadomości. Numery muszą posiadać międzynarodowy format (Np. 48123456789)	Array	TAK
text	Treśc wiadomości która zostanie wysłana	String	TAK
callback	Adres WWW na który odesłane zostaną statystki. Statystyki zostają zapisywane również w panelu Hotsender dlatego też w przypadku braku parametru callback istnieje możliwość odwołania się do nich w przyszłości	String	NIE
callbackData	Dodatkowe dane przesyłane w wypadku podania adresu callback. Np. tajny kod przypisany do danej wysyłki lub większa ilość danych w formacie JSON.	String	NIE

PRZYKŁAD UŻYCIA ( PHP )

<?php
	// dane wymagane do uwierzytelnienia
	$publickey 	= 'TWOJ_PUBLIC_KEY';
	$apikey		= 'TWOJ_API_KEY';
	
	// przygotowanie danych do wysyłki
	$data = array(
		'callback' => 'http://adresOdpowiedzi.pl',
		'callbackData' => md5(sha1(uniqid("sekretny_token"))),
		'from' 	=> 'Nazwa Nadawcy',
		'to'	=> array(
			'48123456789', '48987654321'
		),
		'text'	=> 'Treść Smsa'
	);

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_REFERER, "http://twojastrona.pl");
    curl_setopt($ch, CURLOPT_URL,"https://hotsender.pl/api/v1/sms/multi");
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
	//Ustawianie typu autoryzacji
	curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
	//Przekazywanie danych do logowania
	curl_setopt($ch, CURLOPT_USERPWD , "$publickey:$apikey");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 0);
    curl_setopt($ch, CURLOPT_TIMEOUT,60);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'accept: application/json',
        "content-type: application/json"
    ));

    $output = curl_exec($ch);
	$output = json_decode($output);
    curl_close($ch);

	if($output->status == 101){
		echo "Udało się! {$output->message}";
	} else { 
	    echo "Błąd : {$output->message}";
	}
?>

ZWRÓCONA ODPOWIEDŹ W FORMACIE JSON

{
    "error" : false,
    "status" : 101,
    "message" : "Dane przekazane do operatorów",
    "campaignDetails" : {
            "price" : 0.14,
            "currency" : "PLN",
            "bulkId" : "1490884709525438512"
    }
}

OPIS ODPOWIEDZI

Parametr	Typ	Opis
error	Boolean	TRUE jeżeli wystąpi jakikolwiek błąd, FALSE jeżeli nie ma błędów
status	Integer	Kod odpowiedzi zwrotnej. Wszystkie kody odpowiedzi TUTAJ
message	String	Wiadomośc przypisana do kodu odpowiedzi. Wszystkie kody odpowiedzi TUTAJ
campaignDetails	Array	Tablica zwracająca szczegóły dotyczące wysłanej kampanii
price	Float	Łączna cena za wysłaną kampanie sms naliczona w panelu hotsender
currency	String	Waluta w jakiej została naliczona opłata za kampanie
bulkId	String	Identyfikator całej kampanii. Do każdej wiadomości wysłanej w raporcie callback zostanie przypisany ten identyfikator

Hotsender Dokumentacja

POST Wysyłka masowych wiadomości SMS

ADRES

OPIS

PARAMETRY

PRZYKŁAD UŻYCIA ( PHP )

ZWRÓCONA ODPOWIEDŹ W FORMACIE JSON

OPIS ODPOWIEDZI