API: відмінності між версіями
Sv (обговорення | внесок) Немає опису редагування |
Sv (обговорення | внесок) |
||
Рядок 98: | Рядок 98: | ||
<source lang="bash"> | <source lang="bash"> | ||
curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a= | curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_message' \ | ||
--cookie "noses=hHuidO6MqAwTcqO/nZF4Qg" | --cookie "noses=hHuidO6MqAwTcqO/nZF4Qg" \ | ||
-X POST -d "msg=У меня не работает интернет}" | -X POST -d "msg=У меня не работает интернет}" | ||
</source> | </source> |
Версія за 15:56, 8 червня 2016
API запросы выполняются по http(s)-протоколу, в ответ приходит json. Если в ответе присутствует ключ error - произошла ошибка.
Тестировать API можно с консоли, например:
curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl'
В ответ приходит сообщение об ошибке "запрос не авторизован":
{
"error" : "unauthorized"
}
Необходимо сперва залогиниться под логином и паролем пользователя и получить идентификатор сессии, который использовать в cookie в последующих запросах
В cookie в параметре nolang можно указать язык, например, nolang=UA
Авторизация
Логин: test email Пароль: 123
curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?_mod=external&_uu=test%20email&_pp=123'
Если логин и пароль верные, приходит ответ:
{
"ses" : "hHuidO6MqAwTcqO/nZF4Qg",
"data" : {
"trust" : 1,
"id" : "357",
"role" : "user"
},
"result" : "auth ok"
}
Нас интересует параметр ses, который необходимо посылать во всех запросах в cookie с именем noses
Получение данных пользователя
curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_main' --cookie "noses=hHuidO6MqAwTcqO/nZF4Qg"
В полученном ответе:
usr: данные пользователя messages: сообщения для пользователя services: услуги, подключенные пользователю tmp_pays: кредиты last_pay: данные по последнему платежу
Например:
{
"messages" : [
{
"timestamp" : "1465391425",
"text" : "Здравствуйте. Это тестовое сообщение",
"time" : "Сегодня в 16:10",
"id" : "4344",
"lang_code" : "msg_from_adm"
}
],
"services" : [
{
"service_id" : "33",
"frozen" : null,
"text" : "21.01.2016 09:13 подключена услуга: 50 Mb unlim",
"id" : "1256",
"title" : "50 Mb unlim",
"time_start" : "1453360404",
"time_left" : -11944491,
"next_service_price" : "10",
"next_service_id" : "33",
"next_service_title" : "50 Mb unlim"
},{
...
}
}
Видно, что клиенту отправлено одно сообщение. При этом:
lang_code: msg_from_adm - сообщение от администрации change_srv_order_u - клиент заказал услугу change_srv_order - заказал клиенту услугу кто-то иной (администратор, например)
Также видно, что подключено несколько услуг (2я и последующие заменены на троеточие). next_service_id - id услуги, которая будет подключена когда завершится текущая. Поскольку service_id = next_service_id - будет подключена таже услуга, которая действует в данный момент
Отправка сообщения администрации
curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_message' \
--cookie "noses=hHuidO6MqAwTcqO/nZF4Qg" \
-X POST -d "msg=У меня не работает интернет}"