Работа с «Черным списком»

«Черным список» это список номеров, на которые не уходят сообщения.
Номер в «черный список» можно добавить с помощью запроса к нашему API.

Описание GET/POST-запроса

GET-запросы передаются на адрес:
https://auth.terasms.ru/outbox/add2black

Пример запроса:
https://auth.terasms.ru/outbox/add2black/?login=terasms&password=12345&target=79017654321,79885671234&comment=Текст комментария

Параметр comment  необязательный. Если он указан, то комментарий будет добавлен ко всем номерам из параметра target.

Если все параметры верны, то номера будут добавлены в список и исключены из будущих рассылок.
Возвращаемое значение — список добавленных номеров и время их добавления, в формате CSV.
В противном случае возвращается отрицательное число — код ошибки. Возможные коды ошибок приведены в Описании статусов ошибок

ВНИМАНИЕ!
— Количество номеров в одном запросе не должно превышать 500;
— Если указывается комментарий, то он должен быть в кодировке UTF-8.

Возможный вариант реализации на языке программирования php:

Добавление в список одного и более номеров

$api_uri = 'https://auth.terasms.ru/outbox/add2black/';
$query_array = array(
    'login' => 'login',
    'password' => 'password',
    'target' => 'target1,target2,target3',
    'comment' => 'Комментарий'
);
$get_string = http_build_query( $query_array );
$id = file_get_contents( $api_uri . '?' . $get_string);

Ответ придет в формате:

"target1";"date_time1";"comment"
"target2";"date_time2";"comment"
"target3";"date_time3";"comment"

Экспорт номеров черного списка

Запросы передаются на адрес:
https://auth.terasms.ru/outbox/get_black_list

Пример запроса:
https://auth.terasms.ru/outbox/get_black_list/?login=terasms&password=12345

Ответ придет в формате:

712312341;comment
712312342;comment
712312343;comment