API Тракмаркета: продвижение объявлений

API позволяет выделить ваше объявление среди других и показать большему числу пользователей, чтобы продать транспорт быстрее.

Способы продвижения

Приоритетный показ — закрепим ваше объявление в начале списка над бесплатными объявлениями.
Выделение цветом — закрепим ваше объявление в начале списка + выделим его цветом, чтобы привлечь больше внимания.
Турбопродажа — закрепим ваше объявление в начале списка + выделим его цветом + покажем в других разделах сайта — в поиске грузов, транспорта и так далее.

Подробнее

Термины

ID объявления — уникальный идентификатор, который есть у каждого объявления. Представляет собой строку из 24 символов.

Стоимость в атисах

	3 дня	7 дней	14 дней	30 дней
Приоритетный показ	69	119	199	390
Выделение цветом	99	169	299	560
Турбопродажа	149	279	499	890

Метод

Позволяет продвинуть объявление. Необходимо передать ID объявления, тип и срок действия продвижения.

post

/truckmarket/api/v1/billing/transports/promotion

Развернуть все Свернуть все

body

Объект создан, в ответ приходит он же, но с id

{...}

advert_id: string

ID объявления

promotion: enum

[priority, highlighting, turbo_sale]

Тип продвижения.
'priority': 'Приоритетный показ',
'highlighting': 'Выделение',
'turbo_sale': 'Турбо продажа'

period: enum

[3, 7, 14, 30]

Период оплаты в днях

}

CURL

Копировать

Пример ответа

Ответ

200 Объявление удалено

Развернуть все Свернуть все

Пример

Модель

{...}

"ok":false,

"result":{}

}

{...}

Запрос успешно выполнен

ok: enum

[true]

result:{}

Результат запроса

}

400 Некорректные параметры запроса

Развернуть все Свернуть все

Пример

Модель

{...}

"error":"string",

"reason":"string",

"error_list":[...]

{...}

"error":"string",

"reason":"string"

}

]

}

{...}

Возвращаемое значение в случае ошибок

error*: string

В некоторых случаях (валидация) - ID ошибки, например ApplicationAlreadyCreated в случае "вы уже подали заявку на эту площадку"

reason*: string

Человекочитаемый (ну, почти всегда) текст ошибки

error_list:[{...}]

Человекочитаемый (ну, почти всегда) текст ошибки

error: string

Возвращаемое значение в случае ошибок

reason: string

Возвращаемое значение в случае ошибок

}]

}

404 Объявление не найдено

Развернуть все Свернуть все

Пример

Модель

{...}

"error":"string",

"reason":"string"

}

{...}

Возвращаемое значение в случае ошибок

error*: string

reason*: string

Человекочитаемый (ну, почти всегда) текст ошибки

}

Загрузка...

Развернуть все Свернуть все

Загрузка...