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": "Необходима авторизация"
      }
    }

API Пкаско

Расчет

API ПКАСКО - Введение

Авторизация