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

Модель и примеры

Запрос

Модель

{...}

advert_id: string

ID объявления

promotion: enum

[priority, highlighting, turbo_sale]

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

period: enum

[3, 7, 14, 30]

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

}

Пример запроса

CURL

curl 'https://api.ati.su/truckmarket/api/v1/billing/transports/promotion' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"advert_id":"string","promotion":"priority","period":"3"}'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/truckmarket/api/v1/billing/transports/promotion", "{""advert_id"":""string"",""promotion"":""priority"",""period"":""3""}");

Ответ

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

Модель

{...}

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

ok: enum

[true]

result:{}

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

}

Пример

{...}

"ok":false,

"result":{}

}

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

Модель

{...}

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

error*: string

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

reason*: string

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

error_list:[{...}]

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

error: string

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

reason: string

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

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"error_list":[...]

{...}

"error":"string",

"reason":"string"

}

]

}

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

Модель

{...}

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

error*: string

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

reason*: string

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

}

Пример

{...}

"error":"string",

"reason":"string"

}

Консоль

Отправить

Параметры

Нет параметров

{ "advert_id": "string", "promotion": "priority", "period": "3" }