Цифра

Водители

Метод для создания или обновления водителей в Цифре из 1С.

POST /api/driver/create
Функционал отключён

Данный API-метод в настоящее время отключён. API возвращает успешный ответ, но данные водителей не обрабатываются и не сохраняются в системе.

Используйте этот метод только для тестирования интеграции. Для добавления водителей используйте интерфейс Цифры.

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

Параметры запроса

Параметр Тип Обязательный Описание
SecretKey string Да Секретный ключ
Data array Да Массив водителей

Структура Data[]

Структура полей в настоящее время не задана — метод отключён и не валидирует содержимое.

Примечания
  • ВАЖНО: данный функционал в настоящее время отключён
  • API возвращает успешный ответ, но данные водителей НЕ обрабатываются
  • Данные НЕ сохраняются в системе Цифра
  • Используйте интерфейс Цифры для добавления водителей
Пример запроса 1С → Цифра
{
  "SecretKey": "2akgzOCYsAxLwpNl",
  "Data": [
    {

    }
  ]
}

Коды ответов

КодОписание
201API вернул успешный ответ (success: true)
403Ошибка ключа. Секретный ключ не найден (success: false)
422Ошибка валидации. Data должен быть массивом (success: false)
500Ошибка сервера. Внутренняя ошибка обработки (success: false)

Структура ответа

Поле Тип Описание
successbooleanУспешность операции
messagestringСообщение о результате
data_idintegerID записи в логе

Ключи ответа — в нижнем регистре: message, а не Message. Поле data_id приходит со значением null, если секретный ключ не найден.

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

{
  "success": true,
  "message": "Водители добавлены",
  "data_id": 123
}
{
  "success": false,
  "message": "Секретный ключ не найден",
  "data_id": null
}
{
  "success": false,
  "message": "Неверный тип данных",
  "data_id": 123
}
{
  "success": false,
  "message": "Произошла внутренняя ошибка",
  "data_id": 123
}

Подробности внутренней ошибки в ответ не попадают: причина фиксируется на стороне Цифры, искать её в теле ответа не нужно. Если ошибка повторяется — обратитесь в поддержку Цифры, указав data_id.

См. также