HotSender API | Filtracja numerów

POST Filtracja numerów

ADRES

https://hotsender.pl/api/v1/number/filtering

OPIS

Numery zostają przefiltrowane w systemach operatorów a następnie zwracane zostają tylko poprawne numery oraz ilość błednych i poprawnych numerów w liczbach.

Uwaga
Zalecamy przesyłanie numerów w formacie międzynarodowym(prefix+numer) np. 48999888777. Numery bez prefixów zostajną uznane za błędne.

PARAMETRY

Parametr	Opis	Typ	Wymagany
numbers	Lista numerów telefonu do przefiltrowania	Array	TAK

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(
		'numbers' => array(
			'48123456789', '48987654321'
		)
	);

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_REFERER, "https://twoja-strona.pl");
    curl_setopt($ch, CURLOPT_URL,"https://hotsender.pl/api/v1/number/filtering");
    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);
	echo $output;
	$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" : "Numery zostały przefiltrowane",
    "results" : {
        "48123456789"
    },
    "goodCount" : 1,
    "wrongCount" : 1
}

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
results	Array	Działające, przefiltrowane numery telefonów
goodCount	String	Liczba poprawnych numerów
wrongCount	String	Liczba błędnych numerów

Hotsender Dokumentacja