¶ Начало работы с Plusofon API
версия от 2023-07-17
Plusofon API работает по стандарту REST API. Название метода, как правило, состоит из названия модуля и названия метода в этом модуле, и разделяется символом /.
¶ Условные обозначения
⁎ — обязательный параметр
i — ссылка на описание связанного метода или сущности
/ value — обозначение следующего уровня в структуре (например, элемент объекта или массива)
¶ Частые вопросы
¶ Где взять значение заголовка "Client"?
Для Plusofon API этот заголовок всегда имеет значение 10553.
¶ Как прочитать JSON в теле ответа?
Чтобы получить ответ в JSON-формате можно использовать следующую конструкцию:
$json = file_get_contents('php://input');
$data = json_decode($json);
echo $data->content; # Для отладки
$filename = 'text.txt';
file_put_contents($filename, $data->content);
¶ Как отправить запрос из командной строки Windows?
Для этого можно воспользоваться примером запроса, размещённом на вкладке Bash.
Нужно учесть, что команда CURL в терминале Windows не воспринимает:
-
переносы — нужно убрать их вместе с обратными слэшами (
\) -
одинарные кавычки (
') — необходимо заменить их на экранированные двойные кавычки (\")
Например, метод отправки вызова услуги Flash Call будет выглядеть так:
curl -X POST "https://restapi.plusofon.ru/api/v1/flash-call/send" -H "Content-Type: application/json" -H "Accept: application/json" -H "Client: 10553" -H "Authorization: Bearer ТОКЕН" -d "{\"phone\":\"НОМЕР\"}"
