API ПКАСКО - Введение
Работа с API ПКАСКО происходит по протоколу HTTP и представляет собой обычные REST запросы.
В качестве формата данных используется JSON.
Обратите внимание, что сам сервис pkasko.com использует это же API, соответсвенно его можно использовать как живой пример, если просто открыть консоль разработчка в браузере и отследить все необхожимые запросы.
Для использования API вам потребуется работающий аккаунт в pkasko.com, для этого вам необходимо заранее зарегистрировать его. Вам будет выделена одна тестовая неделя и 30 уникальных расчетов. На время разработки возможно продление доступа по согласованию, после - аккаунт нужно будет оплатить.
Авторизация
Для выполнения любого запроса к API предварительно нужно получить токен авторизации.
Токен получается путем авторизации, используя логин и пароль. Время жизни токена составляет 14 дней с момента получения - поэтому не нужно запрашивать авторизацию перед каждым запросом, на вашей стороне достаточно закешировать его и обновлять не реже чем раз в две недели.
ЗАПРОС
GET https://pkasko.com/auth/api?login=me@pkasko.ru&password=123456ОПИСАНИЕ
login: (string) - логин password: (string) - парольОТВЕТ
{ api_key: "2b509876ca4d77a18e57e4337d9921d3a0ac29c29c7c4851a1e4de6932c18888" }
Полученный токен нужно будет указывать в заголовке HTTP запроса X-Authorization при каждом запросе
GET https://pkasko.com/calcservice/cars Host: pkasko.com User-Agent: Mozilla/5.0 (compatible; PkaskoApiClient/1.0; +https://pkasko.com) X-Authorization: 2b509876ca4d77a18e57e4337d9921d3a0ac29c29c7c4851a1e4de6932c18888
Если время жизни токена истекло, то в ответ на любой запрос будет возвращена структура с ошибкой:
{ "error": { "message": "Необходима авторизация" } }