«Черным список» это список номеров, на которые не уходят сообщения.
Номер в «черный список» можно добавить с помощью запроса к нашему 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