Обновление группы агентов

Обновление данных Группы агентов в Лайнере.

Адрес и метод

POST /v2/agent-group/update/{id}/

id int
Идентификатор группы агентов в Лайнере. Значение > 0.

Параметры (Body)

Передавайте только те поля, которые нужно обновить.

names object необязательный
Объект, в котором содержаться названия группы агентов на разных языках.

names.ru string необязательный
Название группы агентов на русском языке.

names.gb string необязательный
Название группы агентов на английском языке.

agentIds array<int> необязательный
Массив, содержащий идентификаторы агентов, который привязаны к группе.

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

CURLPHP (cURL)JavaScript (fetch)

curl -X POST "https://YOUR_LINER_API_HOST/v2/agent-group/update/{id}/" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -d '{
    "names": {
      "ru": "{{nameRu}}",
      "gb": "{{nameGb}}"
    },
    "agentIds": [{{agentId}}, ...]
  }'

<?php

$host = 'https://YOUR_LINER_API_HOST';
$token = 'YOUR_API_TOKEN';
$id = (int)$id;

// Важно: заполняйте только те поля, которые хотите обновить
$payload = [
    'names' => isset($names) ? $names : null,
    'agentIds' => isset($agentIds) ? $agentIds : null,
];

// Удаляем null-поля, чтобы не затирать значения случайно
$payload = array_filter($payload, fn($v) => $v !== null);

$ch = curl_init($host . '/v2/agent-group/update/' . $id . '/');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-Api-Key: ' . $token,
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_TIMEOUT => 15,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($response === false) {
    throw new RuntimeException('cURL error: ' . curl_error($ch));
}

curl_close($ch);

echo "HTTP {$httpCode}\n";
echo $response;

const host = "https://YOUR_LINER_API_HOST";
const token = "YOUR_API_TOKEN";
const id = Number(id);

// Важно: добавляйте только те поля, которые хотите обновить
const payload = {
  names: names ?? undefined,
  agentIds: agentIds ?? undefined,
};

// Удаляем undefined-поля
Object.keys(payload).forEach((k) => payload[k] === undefined && delete payload[k]);

const res = await fetch(`${host}/v2/agent-group/update/${id}/`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": token
  },
  body: JSON.stringify(payload)
});

const data = await res.json();
console.log("HTTP", res.status, data);

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

{
  "success": true,
  "message": "",
  "data": []
}

Примечание

Выше описана структура поля data. Общий формат ответа API см. в разделе Схема запросов