assessment/find

Връща списък с оценките направени от потребителя

Заявка

1.json

{
    "key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

2.json

{
    "filter": {
        "make": [
            "NISSAN"
        ],
        "model": [
            "JUKE"
        ],
        "year": "2000-2015",
        "value": "50000-100000",
        "plate": "123",
        "chassis": "321",
        "mileage": "50000",
        "cc": "20000-50000",
        "fuel": "PETROL",
        "body": "SEDAN",
        "doors": "2\/3",
        "transmission": "MANUAL",
        "ownertype": "PRIVATE",
        "date": {
            "from": "2014-12-01",
            "to": "2014-12-31"
        }
    },
    "offset": 0,
    "limit": 100,
    "language": "bulgarian",
    "key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
  • params object
    Параметри на заявката
    • params.key stringrequired
      Оторизационен ключ за достъп до сървъра. Виж user/login
    • params.language string[]
      Списък от марки, по които да бъде ограничен резултата.
    • params.offset string[]
      Брой резултати които да бъдат пропуснати. Използва се при странициране.
    • params.limit string[]
      Ограничаване на броя върнати резултати. Използва се при странициране. Ако липсва или е 0 - връща всички резултати.
    • params.filter object
      списък с полета за филтриране на резултата
      • params.filter.make string[]
        Списък от марки, по които да бъде ограничен резултата.
      • params.filter.model string[]
        Списък от модели, по които да бъде ограничен резултата.
      • params.filter.year string
        Ограничава резултата, по година на производство на автомобила. Поддържа синтаксис за обсег [1]
      • params.filter.value string
        Ограничава резултата по действителна стойност. Поддържа синтаксис за обсег [1]
      • params.filter.plate string
        ограничава резултата по регистрационен номер на автомобил
      • params.filter.chassis string
        ограничава резултата по регистрационен номер на рама
      • params.filter.mileage string
        ограничава резултата по километри. Поддържа синтаксис за обсег [1]
      • params.filter.cc string
        ограничава резултата по обем на двигателя. Поддържа синтаксис за обсег [1]
      • params.filter.fuel string
        ограничава резултата по тип гориво.
      • params.filter.body string
        ограничава резултата по тип каросерия.
      • params.filter.doors string
        ограничава резултата по брой на вратите.
      • params.filter.ownertype string
        ограничава резултата спрямо тип собственик.
      • params.filter.date object
        • params.filter.date.from string
          връща оценки направени след определена дата включително. Формат (yyyy-mm-dd)
        • params.filter.date.to string
          връща оценки направени преди определена дата включително. Формат (yyyy-mm-dd)
      • params.filter.user_id int
        връща оценки направени от определен потребител
      • params.filter.external_id int
        Връща оценки съответстващи на определено външно id
    • params.rules string[]
      Поддържа правила за редуциране на отговора. [2]

Отговор

1.json

{
    "data": [
        {
            "id": "244",
            "request_id": "244",
            "user_id": "1",
            "market": "de",
            "make": "LAND ROVER",
            "model": "DISCOVERY",
            "chassis": "sdfsdf",
            "plate": "asdasd",
            "fuel": "DIESEL",
            "body": "JEEP",
            "ownertype": "DEALER",
            "transmission": "MANUAL",
            "doors": "4\/5",
            "x4x4": "0",
            "leather": "0",
            "air_condition": "1",
            "sat_nav": "1",
            "imported": "0",
            "mileage": "100000",
            "year": "2012",
            "cc": "2993",
            "power_output_hp": "256",
            "value": "29700",
            "value_modifier": "0",
            "date_created": "2016-01-27 15:04:46",
            "new_version": "0",
            "duplicated": "0",
            "creator_value": null,
            "creator_remark": null,
            "expert_value": null,
            "expert_remark": null,
            "expert_id": null,
            "case_id": null,
            "object_id": null,
            "external_id": "0",
            "original_value": "29700",
            "original_value_unit": "EUR",
            "stat_value": "29700",
            "stat_value_unit": "EUR",
            "avg_value": "0",
            "avg_value_unit": "",
            "fuel_name": "Дизел",
            "body_name": "Джип",
            "doors_name": "4\/5",
            "transmission_name": "Ръчни",
            "ownertype_name": "Авт. Къща"
        },
        {
            "...": "..."
        }
    ],
    "total": 113
}
  • result object
    Резултат от заявката
    • result.total int
      Общия брой оценки намерени по подадените критерии.
    • result.data object[]
      Масив от върнатите оценки. Може да е празен.
      • result.data.id int
        уникален идентификатор на оценката в системата.
      • result.data.request_id intignore
        Id на извършената заявка. Съвпада с id, освен ако не е активирана допълнителна настройка за кеширане
      • result.data.user_id int
        уникален идентификатор на потребителя, създал оценката.
      • result.data.market string
        Пазар, на който е извършена оценката ('bg', 'de', 'pt')
      • result.data.make string
        марка на автомобила.
      • result.data.model string
        модел на автомобила.
      • result.data.chassis string
        номер на рама.
      • result.data.plate string
        рег.номер.
      • result.data.fuel string
        тип гориво (id).
      • result.data.fuel_name string
        тип гориво (наименование).
      • result.data.body string
        тип каросерия (id).
      • result.data.body_name string
        тип каросерия (наименование).
      • result.data.ownertype string
        тип собственик (id).
      • result.data.ownertype_name string
        тип собственик (наименование).
      • result.data.transmission string
        тип скоростна кутия (id).
      • result.data.transmission_name string
        тип скоростна кутия (наименование).
      • result.data.doors string
        брой врати (id).
      • result.data.doors_name string
        брой врати (наименование).
      • result.data.x4x4 int
        дали автомобилеът е 4x4.
      • result.data.leather int
        дали автомобилеът е с кожен салон.
      • result.data.air_condition int
        дали автомобилеът е с климатик.
      • result.data.sat_nav int
        дали автомобилеът е със навигация.
      • result.data.imported int
        дали автомобилеът е нов внос.
      • result.data.mileage int
        изминати километри.
      • result.data.year int
        година на производство.
      • result.data.cc int
        обем на двигателя.
      • result.data.power_output_hp int
        мощност на двигателя.
      • result.data.original_value double
        Оригиналната стойност на оценката. value = original_value * value_modifier
      • result.data.value double
        оценка стойност. Съвпада в original_value. Освен ако няма допълнителна настройка на увеличение.
      • result.data.value_modifier int
        Допълнително оскъпяване на оценката в %. value = original_value * value_modifier
      • result.data.original_value_unit string
        Валута
      • result.data.stat_value double
        Статистическа стойност на оценката
      • result.data.stat_value_unit string
        Валута
      • result.data.avg_value double
        Цена на пазарни аналози
      • result.data.avg_value_unit string
        Валута
      • result.data.date_created string
        дата на извършване на оценката "yyyy-mm-dd hh:mm:ss".
      • result.data.extra stringignore
        Допълнителна информация към оценката.
      • result.data.new_version intignore
        id-то на новата оценка, ако текущата е използвана за създаване на нова.
      • result.data.duplicated intignore
      • result.data.creator_value doubleignore
      • result.data.creator_remark stringignore
      • result.data.expert_value doubleignore
      • result.data.expert_remark stringignore
      • result.data.expert_id intignore
      • result.data.case_id intignore
      • result.data.object_id intignore
      • result.data.external_id int
        Външно id

assessment/findById

Връща само 1 оценка отговаряща на съответния идентификатор

Заявка

1.json

{
    "id": 171,
    "language": "bulgarian",
    "key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
  • params object
    Параметри на заявката
    • params.key stringrequired
      Оторизационен ключ за достъп до сървъра. Виж user/login
    • params.id intrequired
      Уникалния идентификатор на оценката.
    • params.language string[]
      Списък от марки, по които да бъде ограничен резултата.

Отговор

1.json

{
    "id": "171",
    "user_id": "33",
    "request_id": "171",
    "market": "de",
    "make": "CITROEN",
    "model": "BERLINGO",
    "chassis": "",
    "plate": "EE5555EE",
    "fuel": "DIESEL",
    "body": "PICKUP",
    "ownertype": "PRIVATE",
    "transmission": "MANUAL",
    "doors": "4\/5",
    "x4x4": "0",
    "leather": "0",
    "air_condition": "1",
    "sat_nav": "1",
    "imported": "0",
    "mileage": "55555",
    "year": "2005",
    "cc": "1970",
    "power_output_hp": "155",
    "value": "16040",
    "value_modifier": "0",
    "date_created": "2014-12-09 10:43:29",
    "new_version": "172",
    "duplicated": "0",
    "creator_value": "15",
    "creator_remark": "",
    "expert_value": "55000",
    "expert_remark": "",
    "expert_id": "1",
    "case_id": null,
    "object_id": null,
    "external_id": "0",
    "original_value": "29700",
    "original_value_unit": "EUR",
    "stat_value": "29700",
    "stat_value_unit": "EUR",
    "avg_value": "0",
    "avg_value_unit": "",
    "fuel_name": "Дизел",
    "body_name": "Пикап",
    "doors_name": "4\/5",
    "transmission_name": "Ръчни",
    "ownertype_name": "Частно Лице",
    "chart": [
        {
            "x": "2014-08",
            "y1": "33150",
            "y2": "0"
        },
        {
            "x": "2015-02",
            "y1": "31750",
            "y2": "0"
        },
        {
            "x": "2015-08",
            "y1": "30850",
            "y2": "0"
        }
    ]
}
  • result object
    Връща 1 оценка със същите полета като assessment/find + някои допълнителни данни
    • result.chart object[]
      Данни със информация за точки за изрисуване на графика на цените във времето
      • result.chart.x string
        Време (YYYY-MM)
      • result.chart.y int
        Статистическа оценка
      • result.chart.y2 int
        Цена на пазарни аналози

assessment/save

Създава нова оценка

Заявка

1.json

{
    "assessment": {
        "make": "0",
        "model": "0",
        "plate": "",
        "chassis": "",
        "fuel": "CNG\/PETROL",
        "body": "BUS\/MINIBUS",
        "transmission": "AUTOMATIC",
        "doors": "2\/3",
        "ownertype": "DEALER",
        "leather": true,
        "imported": true,
        "mileage": "",
        "year": "",
        "cc": "",
        "power_output_hp": "",
        "case_id": "0",
        "object_id": "0",
        "id": 0
    },
    "language": "bulgarian",
    "key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
  • params object{}
    данни за оценката.
    • params.key string
      Оторизационен ключ за достъп до сървъра. Виж user/login
    • params.language string[]
      Списък от марки, по които да бъде ограничен резултата.
    • params.assessment object{}
      данни за оценката.
      • params.assessment.market string
        Пазар, на който да бъде извършена оценката ('bg', 'de', 'pt'). По подразбиране 'bg'
      • params.assessment.make string
        марка от номенклатурата.
      • params.assessment.model string
        модел от номенклатурата за посочената марка.
      • params.assessment.plate string
        регистрационен номер
      • params.assessment.chassis string
        рама номер
      • params.assessment.fuel string
        тип гориво от номенклатурата.
      • params.assessment.body string
        ти каросерия от номенклатурата.
      • params.assessment.transmission string
        тип скоростна кутия от номенклатурата.
      • params.assessment.doors string
        брой врати от номенклатурата.
      • params.assessment.ownertype string
        тип собственик от номенклатурата.
      • params.assessment.x4x4 boolean
        Дали автомобилът е 4x4.
      • params.assessment.leather boolean
        Дали автомобилът е с кожен салон.
      • params.assessment.air_condition boolean
        Дали автомобилът е с климатична система.
      • params.assessment.sat_nav boolean
        Дали автомобилът е с навигация.
      • params.assessment.imported boolean
        Дали автомобилът е нов внос.
      • params.assessment.mileage int
        изминати километри
      • params.assessment.year int
        година
      • params.assessment.cc int
        обем на двигателя
      • params.assessment.power_output_hp int
        мощност на двигателя
      • params.assessment.case_id int
        идентификатор на претенция, към която да бъде прикачена оценката
      • params.assessment.object_id int
        идентификато на превозно средство към което да бъде прикачена оценката
      • params.assessment.id int
        идентификатор на друга оценка, в която да бъде записана референция към тази
      • params.assessment.external_id int
        Външно id

Отговор

1.json

175
  • result int
    Идентификатор на направената оценка.

assessment/getNomenclatures

Връща списък с номенклатурите необходими за изготвяне на оценка

Заявка

1.json

{
    "key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
  • params object
    Параметри на заявката
    • params.key stringrequired
      Оторизационен ключ за достъп до сървъра. Виж user/login

Отговор

1.json

{
    "make": [
        "ALFA ROMEO",
        "AUDI",
        "..."
    ],
    "model": {
        "FORD": [
            "C-MAX",
            "CONNECT",
            "..."
        ],
        "RENAULT": [
            "5",
            "9",
            "..."
        ],
        "...": "..."
    },
    "fuel": {
        "CNG\/PETROL": "Метан\/Бензин",
        "DIESEL": "Дизел",
        "LPG\/PETROL": "Газ\/Бензин",
        "PETROL": "Бензин"
    },
    "body": {
        "BUS\/MINIBUS": "Бус",
        "PICKUP - JEEP": "PICKUP - JEEP",
        "VAN": "Ван",
        "SEDAN": "Седан",
        "PICKUP": "Пикап",
        "LIMOUSINE": "Лимузина",
        "JEEP": "Джип",
        "HATCHBACK": "Хечбек",
        "ESTATE": "Комби",
        "COUPE": "Купе",
        "CONVERTIBLE": "Кабриолет",
        "Катафалка": "Катафалка"
    },
    "doors": {
        "2\/3": "2\/3",
        "4\/5": "4\/5"
    },
    "transmission": {
        "AUTOMATIC": "Автоматични",
        "MANUAL": "Ръчни"
    },
    "ownertype": {
        "DEALER": "Авт. Къща",
        "PRIVATE": "Частно Лице"
    }
}
  • result object
    Връща обект със данни за всички номенклатури нужни за направата на оценка.
    • result.make string[]
      списък с марките
    • result.model object{}
      Списък с моделите
    • result.fuel object{}
      Списък с типът горива
    • result.body object{}
      Списък с типовете каросерии
    • result.doors object{}
      Списък с възможните избори за брой врати
    • result.transmission object{}
      Списък с типовете скоростна кутия
    • result.ownertype object{}
      Списък с типовете собственик