Метод POST /api/v1/connector

Метод позволяет зарегистрировать новый Коннектор в DCC.

Важно!

Первое сообщение в данном методе исходит от Коннектора, DCC в ответе возвращает присвоенный регистрируемому Коннектору id_connector . Поэтому, при регистрации Коннектора, id_connector НЕ указываем.

Если в сообщении id_connector заполнен, то метод POST /api/v1/connector обновляет данные по данному id_connector.

Краткое описание

  • Создаёт новый Коннектор или обновляет существующий.

  • Требуется авторизация (Depends(check_login_pass)).

Request

  • Метод: POST

  • Путь: /connector

  • Тело: JSON, схема ConnectorCreateSchema

    • Поле id_connector — опционально. Если указано, сервер попытается найти существующий коннектор и обновить его; если не найден — создаст новый.

    • Другие поля: name, type, group_name и т.п. — согласно ConnectorCreateSchema.

Алгоритм работы метода

  • Если в теле указан id_connector:

    • вызывается connector_exists(...). Если найден объект — выполняется обновление через sqlmodel_update;

    • если не найден — создаётся новый объект на основе переданных полей.

  • Если id_connector не указан — создаётся новый коннектор.

  • Устанавливается поле ecc_dt = текущая локальная дата/время.

  • Сохраняется в БД (db_session.add + commit + refresh) и возвращается сохранённый объект (ConnectorReadSchema).

Ответ

  • Успех: 200 OK, тело — ConnectorReadSchema (JSON) с данными сохранённого коннектора, включая ecc_dt.

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

{
"id_connector": "connector-123",
"name": "My Connector",
"type": "API",
"group_name": "Group A",
"ecc_dt": "2025-11-14T12:34:56+03:00"
}