Работа с REST API
Пример поиска абонентов по коду
Eсли планируется значительное количество запросов, следует установить отдельную копию приложения hoper, чтобы работа с REST API не вызывала задержек в работе операторов через веб-интерфейс
Python
Импортируем необходимые модули:
import json import logging import sys from http import HTTPStatus from urllib import parse as urllib_parse import requests
Задаём параметры подключения к офису оператора связи:
hoper_url = 'https://hydra.hoper.url/rest/v2/' hoper_login = '########' hoper_password = '*********' http_timeout = 60
Задаём параметры поиска. Строка поиска - latera, тип 2001 - поиск по абонентам
search_string = 'latera' search_subtype = 2001
Инициализируем логгер с выводом в stdout
logger = logging.getLogger() logger.setLevel(logging.INFO) stdout_logger = logging.StreamHandler() logger.addHandler(stdout_logger)
Создаём HTTP-сессию в которой устанавливаем заголовки Content-Type и Accept
http_session = requests.Session()
http_session.headers.update(
{
'Content-Type': 'application/json',
'Accept': 'application/json',
},
)
Для работы с REST необходимо авторизоваться и получить токен для дальнейшего выполнения запросов.
Чтобы получить токен, подготавливаем запрос {"session": {"login": "########", "password": "********"}} и отправляем его по адресу /rest/v2/login
Если авторизация не выполнилась успешно, завершаем работу скрипта
auth_url = urllib_parse.urljoin(hoper_url, 'login')
auth_params = {'session': {'login': hoper_login, 'password': hoper_password}}
response = http_session.post(
auth_url,
timeout=http_timeout,
data=json.dumps(auth_params),
)
if response.status_code != HTTPStatus.CREATED:
logger.error(
'Auth error ({0}): {1}'.format(response.status_code, response.content),
)
sys.exit(1)
Получаем токен, который сервер выдал в теле ответа
auth_result = json.loads(response.content) auth_token = auth_result['session']['token']
и сохраняем его HTTP-сессии в заголовке Authorization со значением Token token=RECEIVED_TOKEN
http_session.headers.update(
{'Authorization': 'Token token={0}'.format(auth_token)},
)
Подготавливаем и отправляем запрос на поиск абонентов
organizations_url = urllib_parse.urljoin(
hoper_url,
'search?result_subtype_id={0}&query={1}'.format(
search_subtype,
search_string,
),
)
response = http_session.get(
organizations_url,
timeout=http_timeout,
)
Если запрос выполнен успешно, по каждой найденной сущности выведем её идентификатор и наименование из результата поиска
if response.status_code == HTTPStatus.OK:
search_results = json.loads(response.content)['search_results']
for entity in search_results:
logger.info(
'Customer `{0}`: `{1}`'.format(
entity['n_entity_id'],
entity['vc_result_name'],
),
)
Если запрос выполнился с ошибкой, выведем предупреждение с полученным от сервера ответом
else:
logger.warning(
'Invalid response ({0}): {1}'.format(
response.status_code,
response.content,
),
)
Полная версия скрипта:
PHP
Задаём параметры подключения к офису оператора связи:
<?php $hoper_url = 'https://hydra.hoper.url/rest/v2/'; $hoper_login = '########'; $hoper_password = '********'; $http_timeout = 60;
Задаём параметры поиска. Строка поиска - latera, тип 2001 - поиск по абонентам
$search_string = 'latera'; $search_subtype = 2001;
Подготавливаем HTTP-заголовки Content-Type и Accept для запросов
$http_headers = [
'Content-Type: application/json',
'Accept: application/json',
];
Для работы с REST необходимо авторизоваться и получить токен для дальнейшего выполнения запросов.
Чтобы получить токен, подготавливаем запрос {"session": {"login": "########", "password": "********"}} по адресу /rest/v2/login
curl_setopt($curl_auth, CURLOPT_POST, true);
curl_setopt($curl_auth, CURLOPT_URL, $hoper_url . "login");
curl_setopt($curl_auth, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_auth, CURLOPT_HTTPHEADER, $http_headers);
curl_setopt($curl_auth, CURLOPT_TIMEOUT, $http_timeout);
curl_setopt($curl_auth, CURLOPT_POSTFIELDS, json_encode(
["session" => ["login" => $hoper_login, "password" => $hoper_password]]
));
выполняем его и получаем результаты. Если авторизация не выполнилась успешно, завершаем работу скрипта
$auth_response = curl_exec($curl_auth);
$auth_status = curl_getinfo($curl_auth, CURLINFO_HTTP_CODE);
curl_close($curl_auth);
if ($auth_status != 201) {
echo "Auth error (" . $auth_status . "): " . $auth_response . "\n";
exit(1);
}
Получаем токен, который сервер выдал в теле ответа и сохраняем его в списке заголовков для следующих запросов
$auth_token = json_decode($auth_response, true)['session']['token']; $http_headers[] = 'Authorization: Token token=' . $auth_token;
Подготавливаем и отправляем запрос на поиск абонентов
$curl_search = curl_init();
curl_setopt($curl_search, CURLOPT_URL,
$hoper_url . "search?result_subtype_id=" . $search_subtype . "&query=" . $search_string
);
curl_setopt($curl_search, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_search, CURLOPT_HTTPHEADER, $http_headers);
curl_setopt($curl_search, CURLOPT_TIMEOUT, $http_timeout);
$search_response = curl_exec($curl_search);
$search_status = curl_getinfo($curl_search, CURLINFO_HTTP_CODE);
Если запрос выполнен успешно, по каждой найденной сущности выведем её идентификатор и наименование из результата поиска. Если запрос выполнился с ошибкой, выведем предупреждение с полученным от сервера ответом
if ($search_status == 200) {
$search_result = json_decode($search_response, true);
foreach ($search_result['search_results'] as $entity) {
echo "Customer: " . $entity['n_entity_id'] . ": " . $entity['vc_result_name'] . "\n";
}
} else {
echo "Invalid response (" . $search_status . "): " . $search_response . "\n";
}
Полная версия скрипта