API ПКАСКО - Справочники

Справочники

Обращаем особое внимание, что справочники которые описаны ниже имеет смысл запрашивать не чаще одного раза в неделю. Мы настоятельно рекомендуем кешировать их на своих серверах, чтобы не превысить допустимое значение запросов.

  1. Справочник компаний и калькуляторов

    Справочник компаний и калькуляторов

    Компании, которые доступны в вашем регионе (в регионе, к которому привязан аккаунт):
    ЗАПРОС

            GET https://pkasko.com/calcservice/companies
            
    Все компании:
    ЗАПРОС
            GET https://pkasko.com/calcservice/companies/all
            
    ОТВЕТ
            [
               {
                  "id": "1",
                  "name": "РЕСО-Гарантия",  // полное имя
                  "nameshort": "РЕСО",      // сокращенное имя
                  ...
                  "calculators": [  // массив калькуляторов компании (может быть несколько калькуляторов, но в большинстве компаний - один)
                     {
                        "code": "RESOWebservice",  // код калькулятора (дальше используется, как основной идентификатор конкретного калькулятора)
                        "user": {
                            "kasko": {
                                "settings": {
                                    "disabled": "1" // Включен или выключен калькулятор КАСКО
                                }
                            },
                            "osago": {
                                "settings": {
                                    "disabled": "0" // Включен или выключен калькулятор ОСАГО
                                }
                            }
                        }
                        ...
                     },
                     { ... }
                  ]
               },
               { ... },
               { ... }
            ]
            

  2. Справочник калькуляторов (хеш по коду калькулятора)

    Калькуляторы, которые доступны в вашем регионе (в регионе, к которому привязан аккаунт):
    ЗАПРОС

            GET https://pkasko.com/calcservice/calculators
            
    Все калькуляторы:
    ЗАПРОС
            GET https://pkasko.com/calcservice/calculators/all
            
    ОТВЕТ
            {
              "RenessansWebservice": {   // код калькулятора
                 "company": { ... 
                    "id": "1",
                    "name": "РЕСО-Гарантия",  // полное имя
                    "nameshort": "РЕСО",      // сокращенное имя
                 },
                 "calculator": {         // информацию о текущем калькуляторе
                    "name": "prod.renins.com",  // имя калькулятора
                    "code": "RenessansWebservice",
                    "policy": 1, // Доступно оформление полиса в принципе в конкретной СК
                    "kasko": true, // Доступно оформление полиса КАСКО
                    "osago": true // Доступно оформление полиса ОСАГО
                 }
              }
           }   
            

  3. Справочник марок и моделей

    Справочник марок и моделей

    ЗАПРОС

            GET https://pkasko.com/calcservice/cars
            
    ОТВЕТ
            [
               {
                  "id": "1",
                  "name": "Acura",
                  "guarantee": "3",        // кол-во лет гарантии у данной марки
                  "models": [
                     {
                        "id": "1",
                        "make_id": "1",
                        "name": "MDX",
                        "domestic": "0",   // 1 - отечественная, 0 - иностранного производства
                        "parent_id": "0",  // если подмодель, то идентификатор главной модели
                        "power": "265",    // мощность, л.с.
                        "weight": "1780",  // вес, кг
                        "price": "1736000" // среднерыночная стоимость, руб.
                     },
                     { ... },
                     { ... }
                  ]
               },
               { ... }
            ]
            

  4. Справочник противоугонных систем

    Справочник производителя и системы

    ЗАПРОС

            GET https://pkasko.com/calcservice/antihijack
            
    ОТВЕТ
            [
                {
                    "id": "1",
                    "name": "Sherlog",
                    "models": [
                        {
                            "id": "1",
                            "make_id": "1",
                            "name": "Comfort"
                        },
                        {
                            "id": "2",
                            "make_id": "1",
                            "name": "Optimum"
                        },
                        {
                            "id": "3",
                            "make_id": "1",
                            "name": "Premium"
                        }
                    ]
                }
            ]
            

  5. Справочник регионов КАСКО

    Справочник регионов

    ЗАПРОС

              GET https://pkasko.com/region/list
              
            
    ОТВЕТ
            [
              {
                "id": "1",
                "okrug_id": "3",
                "country_id": "1",
                "timezone": "0",
                "code": "spb",
                "name": "Санкт-Петербург",
                "name_en": "Saint-Petersburg",
                "declension": "Санкт-Петербурге",
                "domain": "peterburg",
                "kladr": "7800000000000"
              },
              { ... }
            ]
            

  6. Справочник регионов ОСАГО

    Справочник регионов

    ЗАПРОС

              GET https://pkasko.com/region/list/1
            
    ОТВЕТ
            [
              {
                "name": "Санкт-Петербург",
                "kladr": "7800000000000",
                "cities": []
              },
              {
                "name": "Ленинградская область",
                "kladr": "4700000000000",
                "cities": []
              },
              { ... },
              {
                "name": "Алтайский край",
                "kladr": "2200000000000",
                "cities": [
                  {
                    "name": "Алтайский край",
                    "kladr": "2200000000000"
                  },
                  {
                    "name": "Барнаул",
                    "kladr": "2200000100000"
                  },
                  {
                    "name": "Бийск",
                    "kladr": "2200000400000"
                  },
                  {
                    "name": "Заринск, Новоалтайск, Рубцовск",
                    "kladr": "2200001100000"
                  },
                  {
                    "name": "Прочие города и населенные пункты",
                    "kladr": "2200000200000"
                  }
                ]
              },
              { ... }
            ]
            

  7. Расширенные условия расчета КАСКО

    Расширенные условия расчета КАСКО

    ЗАПРОС

            GET https://pkasko.com/kasko/extended?show=2
            
    ОПИСАНИЕ
            show: (int) - уровень доступа к расширенным параметрам (по умолчанию: 2)
            
    Ответ на получение расширенных условий идентичен по структуре ответу на уточняющий запрос (см. раздел Расчеты - Базовые понятия - Уточняющий расчет). Исключение: в ответе на расширенные условия отсутствует блок result.