Создание объявления • APEX Docs

Формат запроса

Тело запроса - JSON-массив объектов объявлений: от 1 до 100 элементов. Порядок в массиве сохраняется: ответ в results на том же индексе, что и элемент в запросе.

Headers

Name	Value	Description
`Authorization`	`Bearer <token>`	Ваш токен
`X-Team-Key`	`<token-team>`	Токен команды

Body

Каждый элемент массива - объект со следующими полями:

Name	Type	Example	Description
service*	`string`	`packeta_hu`	Идентификатор сервиса: название + `_` + код страны (2 символа), например `packeta_hu`. Список сервисов - (посмотреть)
name*	`string`	`Test order`	Название объявления
price*	`number` \| `string`	`1000`	Стоимость товара (неотрицательное число)
user*	`string`	`Mihály Tamás`	Имя и фамилия
address*	`string`	`9146 Budapest`	Адрес
photo	`string`	`https://example.com/img.png`	Ссылка на изображение товара (необязательно)
checker_balance	`boolean`	`true`	Запрашивать ли баланс. По умолчанию: `true`
log_type	`string`	`lk`	Тип лога: только lk или card. Для Германии в объявлении всегда используется lk

Response

Схема ответа

successboolean
true только если успешны все элементы массива results
messagestring
All orders created или Bulk processing completed with errors
resultsarray
Результат по каждому элементу запроса (тот же индекс)
- successboolean
  Успех создания одного объявления
- orderIdnumber
  При success: true - ID объявления
- servicestring
  При success: true - название сервиса
- namestring
  При success: true - название товара
- linkstring
  При success: true - ссылка на объявление
- shortstring
  При success: true - короткая ссылка, если у тебя установлен домен под сокращалку
- messagestring
  При success: false - причина ошибки
- errorsarray
  При success: false - список текстов ошибок

Пример

JSON
  "success": true,
  "message": "All orders created",
  "results": [
      "success": true,
      "orderId": 381868590,
      "service": "Packeta",
      "name": "Test order",
      "link": "https://team-domain.com/381868590",
      "short": "https://my-domain.com/oPOQq0"
      "success": true,
      "orderId": 482917361,
      "service": "Vatera",
      "name": "Second order",
      "link": "https://team-domain.com/482917361"

Пример ответа с ошибками

Если часть элементов не прошла валидацию, HTTP-код будет 200, в корне success: false, message: Bulk processing completed with errors, в results - смесь успешных и неуспешных объектов:

JSON
  "success": false,
  "message": "Bulk processing completed with errors",
  "results": [
      "success": true,
      "orderId": 381868590,
      "service": "Packeta",
      "name": "Test order",
      "link": "https://team-domain.com/381868590"
      "success": false,
      "message": "Error validation",
      "errors": ["name cannot be empty."]