Бренды

GET

Найти бренды

/api/brand/find

Токен с правами чтения

Основной метод для списков, поиска и синхронизации. Возвращает только бренды текущего аккаунта и поддерживает стабильную постраничную выборку.

i

total возвращается только при count=true. Для следующих страниц параметр count можно отключить.

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

Поле	Тип	Обязательно	Описание
`query`	string	Нет	Часть названия бренда, поиск по вхождению.
`deleted`	boolean	Нет	true — только архивные, false — только активные. Без параметра возвращаются оба типа.
`brandOneCId`	string	Нет	Точное совпадение по внешнему идентификатору 1С.
`hasOzonId`	boolean	Нет	true — вернуть только бренды, связанные с Ozon.
`limit`По умолчанию: 50	integer	Нет	Число записей на странице, не более 500.
`page`По умолчанию: 1	integer	Нет	Номер страницы, начиная с 1.
`count`По умолчанию: false	boolean	Нет	Добавить общее число найденных записей в total.
`sortBy`	stringNAME, BRANDID	Нет	NAME — по названию, BRANDID — по внутреннему идентификатору.
`ascending`По умолчанию: false	boolean	Нет	true — по возрастанию, false — по убыванию.

curl --request GET 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поле Тип Обязательно Описание

rows Brand[] Да Бренды текущей страницы.

Структура элемента массива Brand

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

totalУсловие: count=true integer Нет Общее число совпадений; присутствует только при count=true.

page integer Да Номер текущей страницы.

hasNextPage boolean Да true, если можно запросить следующую страницу.

{
  "rows": [
    {
      "brandId": 8124,
      "name": "Base",
      "deleted": false,
      "ozonName": "BASE"
    }
  ],
  "total": 1,
  "page": 1,
  "hasNextPage": false
}

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Получить все бренды

/api/brand/all

Токен с правами чтения

Возвращает полный список брендов аккаунта, отсортированный по названию.

i

Для больших справочников и регулярной синхронизации используйте /find с пагинацией.

curl --request GET 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/all', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/all', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/brand/all',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/all',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/brand/all", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/all"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Структура элемента массива Brand[]

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

[
  {
    "brandId": 8124,
    "name": "Base",
    "deleted": false
  },
  {
    "brandId": 8125,
    "name": "Air",
    "deleted": false
  }
]

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Получить бренд по ID

/api/brand/{brandId}

Токен с правами чтения

Возвращает бренд текущего аккаунта по внутреннему идентификатору.

i

В текущей реализации неизвестный brandId возвращает пустое значение, а не ошибку 404. Проверяйте пустой ответ.

Параметры пути

Поле	Тип	Обязательно	Описание
`brandId`	integer	Да	Идентификатор бренда в SelSup.

curl --request GET 'https://api.selsup.ru/api/brand/8124' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/brand/8124',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/brand/8124", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Brand

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

{
  "brandId": 8124,
  "name": "Base",
  "deleted": false,
  "ozonName": "BASE",
  "ozonId": 100582
}

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Создать бренд

/api/brand

Токен с правами записи

Создаёт бренд в текущем аккаунте. Для обычного сценария достаточно поля name.

i

Название сравнивается без учёта регистра; «Base» и «base» считаются одним брендом.

Тело запроса

application/json

Поле	Тип	Обязательно	Описание
`name`	string	Да	Уникальное непустое название бренда.
`ozonName`	string	Нет	Название из справочника Ozon, если известно.
`ozonId`	integer · int64	Нет	Идентификатор бренда Ozon, если карточки отправляются без предварительного импорта.
`oneCId`	string	Нет	Стабильный внешний ключ бренда в 1С.

curl --request POST 'https://api.selsup.ru/api/brand' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}'

const response = await fetch('https://api.selsup.ru/api/brand', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base",
    "ozonName": "BASE",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base",
    "ozonName": "BASE",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/brand',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Base',
        'ozonName': 'BASE',
        'ozonId': 100582,
        'oneCId': 'BRAND-001'
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/brand", strings.NewReader(`{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Brand

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

{
  "brandId": 8124,
  "name": "Base",
  "deleted": false,
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

400error_empty_brand_name

Пустое название

name отсутствует, пуст или состоит только из пробелов.

400error_brand_already_exists

Бренд уже существует

В аккаунте уже есть бренд с таким названием без учёта регистра. params.name содержит конфликтующее имя.

400error_subscription_expired

Срок действия тарифа закончился

Оплатите тариф для продолжения использования сервиса. Для логики интеграции используйте код error_subscription_expired.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

PUT

Обновить бренд

/api/brand/{brandId}

Токен с правами записи

Полностью обновляет редактируемые поля бренда. Идентификатор берётся из URL, brandId в JSON передавать не нужно.

i

Это PUT, поэтому передавайте все значения, которые нужно сохранить. Поля логотипа этим методом не меняются.

Параметры пути

Поле	Тип	Обязательно	Описание
`brandId`	integer	Да	Идентификатор изменяемого бренда.

Тело запроса

application/json

Поле	Тип	Обязательно	Описание
`name`	string	Да	Новое уникальное название.
`deleted`По умолчанию: false	boolean	Нет	Архивный статус бренда.
`ozonName`	string	Нет	Название бренда в Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Идентификатор бренда в 1С.

curl --request PUT 'https://api.selsup.ru/api/brand/8124' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}'

const response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base Studio",
    "deleted": false,
    "ozonName": "BASE STUDIO",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Base Studio",
    "deleted": false,
    "ozonName": "BASE STUDIO",
    "ozonId": 100582,
    "oneCId": "BRAND-001"
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.put(
    'https://api.selsup.ru/api/brand/8124',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Base Studio',
        'deleted': False,
        'ozonName': 'BASE STUDIO',
        'ozonId': 100582,
        'oneCId': 'BRAND-001'
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124',
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/brand/8124", strings.NewReader(`{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Brand

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

{
  "brandId": 8124,
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}

Ошибки6

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

400error_empty_brand_name

Пустое название

name отсутствует, пуст или состоит только из пробелов.

400error_brand_already_exists

Бренд уже существует

В аккаунте уже есть бренд с таким названием без учёта регистра. params.name содержит конфликтующее имя.

400error_subscription_expired

Срок действия тарифа закончился

Оплатите тариф для продолжения использования сервиса. Для логики интеграции используйте код error_subscription_expired.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

DELETE

Удалить, архивировать или восстановить бренд

/api/brand/{brandId}

Токен с правами записи

При deleted=true SelSup пытается удалить бренд физически. Если на него есть ссылки, бренд помечается удалённым. deleted=false восстанавливает архивный бренд.

Параметры пути

Поле	Тип	Обязательно	Описание
`brandId`	integer	Да	Идентификатор бренда.

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

Поле	Тип	Обязательно	Описание
`deleted`	boolean	Да	true — удалить или архивировать; false — восстановить.

curl --request DELETE 'https://api.selsup.ru/api/brand/8124?deleted=true' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124?deleted=true', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124?deleted=true', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/brand/8124?deleted=true',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124?deleted=true',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/brand/8124?deleted=true", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124?deleted=true"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

brand_has_been_removed

Бренд физически удалён.

brand_signed_as_deleted

Удаление невозможно из-за связей; бренд перемещён в архив.

brand_has_been_restore

Бренд восстановлен из архива.

"brand_signed_as_deleted"

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Загрузить логотип

/api/brand/{brandId}/image

Токен с правами записи

Загружает изображение как multipart/form-data. Если логотип уже существует, он заменяется.

i

Передавайте бинарный файл в поле file; JSON для этого метода не используется.

Параметры пути

Поле	Тип	Обязательно	Описание
`brandId`	integer	Да	Идентификатор бренда.

Тело запроса

multipart/form-data

Поле	Тип	Обязательно	Описание
`file`	binary	Да	Файл изображения поддерживаемого формата.

curl --request POST 'https://api.selsup.ru/api/brand/8124/image' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./logo.png'

const form = new FormData();
form.append('file', fileInput.files[0]);

const response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
  body: form,
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const form: FormData = new FormData();
form.append('file', fileInput.files![0]);

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
  body: form,
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/brand/8124/image',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    files={'file': open('./logo.png', 'rb')},
)
response.raise_for_status()
result = response.json()

<?php

$payload = ['file' => new CURLFile('./logo.png')];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124/image',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "bytes"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
    "path/filepath"
)

func main() {
    var body bytes.Buffer
    writer := multipart.NewWriter(&body)
    file, err := os.Open("./logo.png")
    if err != nil { panic(err) }
    defer file.Close()

    part, err := writer.CreateFormFile("file", filepath.Base(file.Name()))
    if err != nil { panic(err) }
    if _, err = io.Copy(part, file); err != nil { panic(err) }
    writer.Close()

    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/brand/8124/image", &body)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", writer.FormDataContentType())

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        String boundary = "SelSupBoundary" + System.currentTimeMillis();
        byte[] file = Files.readAllBytes(Path.of("./logo.png"));
        byte[] head = ("--" + boundary + "\r\n" +
            "Content-Disposition: form-data; name=\"file\"; filename=\"logo.png\"\r\n" +
            "Content-Type: image/png\r\n\r\n").getBytes(StandardCharsets.UTF_8);
        byte[] tail = ("\r\n--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8);
        byte[] payload = new byte[head.length + file.length + tail.length];
        System.arraycopy(head, 0, payload, 0, head.length);
        System.arraycopy(file, 0, payload, head.length, file.length);
        System.arraycopy(tail, 0, payload, head.length + file.length, tail.length);

        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124/image"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "multipart/form-data; boundary=" + boundary)
            .method("POST", HttpRequest.BodyPublishers.ofByteArray(payload))
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Brand

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

{
  "brandId": 8124,
  "name": "Base",
  "logoUrl": "https://files.selsup.ru/brand/8124.png",
  "logoSize": 18420,
  "logoWidth": 512,
  "logoHeight": 512,
  "deleted": false
}

Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

400error_brand_to_found

Бренд для логотипа не найден

brandId не существует в текущем аккаунте. Код сохранён в документации в том виде, в котором его возвращает API.

400error_wrong_image_format

Неподдерживаемое изображение

Файл не удалось прочитать как изображение поддерживаемого формата.

400error_max_upload_size_exceeded

Файл слишком большой

Размер multipart-запроса превысил допустимый лимит сервера.

400error_subscription_expired

Срок действия тарифа закончился

Оплатите тариф для продолжения использования сервиса. Для логики интеграции используйте код error_subscription_expired.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

DELETE

Удалить логотип

/api/brand/{brandId}/image

Токен с правами записи

Удаляет файл логотипа и обнуляет его размеры в записи бренда.

Параметры пути

Поле	Тип	Обязательно	Описание
`brandId`	integer	Да	Идентификатор бренда.

curl --request DELETE 'https://api.selsup.ru/api/brand/8124/image' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124/image', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/brand/8124/image',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124/image',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/brand/8124/image", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124/image"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Brand

Поле	Тип	Обязательно	Описание
`brandId`	integer	Нет	Идентификатор бренда внутри аккаунта SelSup.
`name`	string	Да	Название бренда. Пробелы по краям удаляются при сохранении.
`logoUrl`	string	Нет	Публичная ссылка на текущий логотип.
`logoSize`	integer	Нет	Размер логотипа в байтах.
`logoWidth`	integer	Нет	Ширина логотипа в пикселях.
`logoHeight`	integer	Нет	Высота логотипа в пикселях.
`deleted`По умолчанию: false	boolean	Нет	Признак архивного бренда.
`ozonName`	string	Нет	Название бренда в каталоге Ozon.
`ozonId`	integer · int64	Нет	Идентификатор бренда в Ozon.
`oneCId`	string	Нет	Внешний идентификатор бренда в 1С.

{
  "brandId": 8124,
  "name": "Base",
  "logoSize": 0,
  "logoWidth": 0,
  "logoHeight": 0,
  "deleted": false
}

Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

400error_brand_to_found

Бренд для логотипа не найден

brandId не существует в текущем аккаунте. Код сохранён в документации в том виде, в котором его возвращает API.

400error_empty_brand_logo

У бренда нет логотипа

Удаление запрошено для бренда, у которого логотип не задан.

400error_cant_remove_brand_logo

Логотип не удалось удалить

Хранилище не смогло удалить файл или обновить данные бренда.

400error_subscription_expired

Срок действия тарифа закончился

Оплатите тариф для продолжения использования сервиса. Для логики интеграции используйте код error_subscription_expired.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Объединить дубликаты

/api/brand/{brandId}/merge/{removeBrandId}

Токен с правами записи

Переносит модели товаров с removeBrandId на brandId, затем физически удаляет removeBrandId.

i

Операция необратима. brandId — бренд, который останется; removeBrandId — дубликат, который будет удалён.

Параметры пути

Поле	Тип	Обязательно	Описание
`brandId`	integer	Да	Идентификатор основного бренда.
`removeBrandId`	integer	Да	Идентификатор удаляемого дубликата.

curl --request POST 'https://api.selsup.ru/api/brand/8124/merge/9012' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/brand/8124/merge/9012', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/brand/8124/merge/9012', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/brand/8124/merge/9012',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/brand/8124/merge/9012',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/brand/8124/merge/9012", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/brand/8124/merge/9012"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Тело ответа пустое.

Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

400error_brand_not_found

Бренд не найден

Один из брендов для объединения не существует в текущем аккаунте.

400error_subscription_expired

Срок действия тарифа закончился

Оплатите тариф для продолжения использования сервиса. Для логики интеграции используйте код error_subscription_expired.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

Готовые сценарии

Найти или создать бренд перед созданием товара

Синхронизировать справочник с 1С

Убрать дубликат без потери связей товаров

Что реально возвращается в Brand

Как API возвращает прикладные ошибки

Методы

Найти бренды

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

Успешный ответ

Получить все бренды

Успешный ответ

Получить бренд по ID

Параметры пути

Успешный ответ

Создать бренд

Тело запроса

Успешный ответ

Обновить бренд

Параметры пути

Тело запроса

Успешный ответ

Удалить, архивировать или восстановить бренд

Параметры пути

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

Успешный ответ

Загрузить логотип

Параметры пути

Тело запроса

Успешный ответ

Удалить логотип

Параметры пути

Успешный ответ

Объединить дубликаты

Параметры пути

Успешный ответ

Токен для тестовых запросов

Параметры реального запроса

Реальный ответ API