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

Взаимодействие с Платформой TERASMS осуществляется по протоколу HTTP/HTTPS. Можно применять как GET, так и POST запросы. Все параметры должны быть переданы в соответствии со спецификацией.

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

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

Пример запроса:
https://auth.terasms.ru/outbox/add2black/?login=terasms&password=12345&target=79017654321,89885671234 &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

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

712312345;comment
712312345;comment
712312345;comment
Готовы начать работу?
Если остались вопросы, свяжитесь с нами по телефону: 8 800 555-9412