Дадзеныя па спасылцы на прадукт · API Падпісанне

Брэды

Стварэнне і пошук брэндаў, іх карта ў Ozon і 1C, кіраванне лагаты, і бяспечна злучэнне дублікатаў.

9 канчатковыя пункты/api/brandСтабільныМашыначытна чытае апісанне ↗

{ }

Кожны прадукт SelSup мае патрэбу ў маркі. Для не маркаваных тавараў, стварыце адмысловы Ні маркі запіс спачатку і выкарыстоўвайце яго ідэнтыфікатар у картках прадукту.

/api/brand

Готовыя да выкарыстання працоўныя патокі

Знайсці або стварыць брэнд перад стварэннем прадукту

Калі радкі пустыя, стварыце брэнд і захоўвайце брэнд-ід для карты прадукту.

Званкі GET /api/brand/find з запытам і count=true.
Параўнайце імя выпадкова неасцярожна ў вашай заяве.
Калі супадзення не існуе, адпраўце POST /api/brand з імем.
Выкарыстоўвайце brandId ад адказу пры стварэнні мадэлі прадукту.

GETЗнайдзіце брэндаў POSTСтварэнне брэнда

Сінхронізаваць каталог з 1C

Захоўвайце ключ 1C ў адзінКіД і прывядзіце старонкі замест загрузкі ўсяго каталога ў адным запыце.

Запрасіце 50500 запісаў адначасова, адрозніваюцца па БРАНДІД.
Паставіце count=true на першым запыце атрымаць агульны.
Стварэнне адсутнічаючых запісаў або абнаўленне супадзенняў, знойдзеных brandOneCId.

GETЗнайдзіце брэндаў POSTСтварэнне брэнда PUTАбноўленне брэнда

Выдаліце дублікат без страты спасылак на прадукт

Fusion пераводзіць мадэлі прадукту з дубліката да першаснай маркі, а затым выдаляе дублікат.

Знайдзіце і праверце абодва ідэнтыфікатары брэнда.
Перадавайце першасную марку і выдаліце дубляж маркі.
Знайдзіце асноўную марку і праверце сувязныя прадукты.

GETАтрымаць марку па пазначэнні POSTДвухпавярховыя падзелкі

Мадэль дадзеных

Полы сапраўды вярнуліся ў Бранд

Полі лага з'яўляюцца пасля загрузкі малюнка. Палі агульнай мадэлі, якія не ўдзельнічаюць у гэтым API, намерна выкідваюцца.

Brand10 палёў

brandIdinteger

Ідэнтыфікатар маркі ў бягучым рахунку SelSup.

read-only

namestring

Назва маркі. Перадавыя і запісныя прасторы выдаляюцца, калі захаваюцца.

Абавязкова

logoUrlstring

Публічны URL бягучага лагатыку.

read-only

logoSizeinteger

Памер лагаты ў байтах.

read-only

logoWidthinteger

Шырыня лага ў пікселях.

read-only

logoHeightinteger

Вышыня лага ў пікселях.

read-only

deletedboolean

Ці будзе марка архівавана.

ozonNamestring

Назва маркі ў каталогу Ozon.

nullable

ozonIdinteger · int64

Ідэнтыфікатар маркі ў Озоне.

nullable

oneCIdstring

Падключэнне да адзнакі маркі

nullable

Памылка дагавор

Як вяртаюць памылкі прыкладання

Код error аднолькавы ў кожным лакелі, у той час як паведамленне, якое з'яўляецца карыстальнікам, перакладаецца серверам.

error

Стабільны машыначытай код для інтэграцыйнай логікі.

localMessage

Паведамленне гатовае да адлюстравання на мове карыстальніка токены API.

params

Значэнні, якія інтэрполююцца серверам у лакалізаваным шаблоне паведамленняў.

文

localMessage выкарыстоўвае поле lang карыстальніка, які валодае токеном API. Мова дакументацыі і загаловак Accept-Language не змяняюць яго; руская выкарыстоўваецца, калі карыстацкая мова не канфігуруецца.

RUМясцовасць карыстальніка ru

{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}

BEБеларуская (be)

{
  "error": "error_brand_already_exists",
  "localMessage": "Брэнд Base ужо існуе",
  "params": {
    "name": "Base"
  }
}

Канчатковыя пункты

GET

Знайдзіце брэндаў

/api/brand/find

Значок з чытальным доступам

Асноўны канчатковы пункт для спісаў, пошуку і сінхрынацыі. Ён вяртае брэндаў з бягучага рахунку і падтрымлівае стабільную старончую размяшчэнне.

Total вяртаецца толькі калі count=true. Адключыць лічба для наступных старонак.

Параметры запытаў

Поле	Тып	Абавязкова	Апісанне
`query`	string	Не	Падпазначэнне для пошуку ў назве брэнда.
`deleted`	boolean	Не	праўдзівы для архіваваных, непраўдзівы - актыўны.
`brandOneCId`	string	Не	Дакладны знешні 1C ідэнтыфікатар.
`hasOzonId`	boolean	Не	верны вяртаць толькі брэндаў, якія адлюстроўваюцца ў Озон.
`limit`Па змаўчанні: 50	integer	Не	Запісы на старонку да 500.
`page`Па змаўчанні: 1	integer	Не	Номер старонкі пачынаючы з 1.
`count`Па змаўчанні: false	boolean	Не	Уключыце агульную колькасць матчаў у агульнай складанасці.
`sortBy`	stringNAME, BRANDID	Не	Назва для назвы маркі, БРАНД для ўнутранага ідэнтыфікатара.
`ascending`Па змаўчанні: false	boolean	Не	праўдзівы для ўзыходзячага, і непраўдзівы ў падзенні.

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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

totalУмова: count=true integer Не Агульная супадзенне; прысутнічае толькі калі count=true.

page integer Так Наступны нумар старонкі.

hasNextPage boolean Так праўда, калі іншая старонка даступная.

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

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

Запіс усіх брэндаў

/api/brand/all

Значок з чытальным доступам

Вяртае ўсе брэндаў у рахунку, адрозніваецца па імёнах.

Для вялікіх каталогаў і паўторнай сінхранізацыі выкарыстоўвайце /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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

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

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

GET

Атрымаць марку па пазначэнні

/api/brand/{brandId}

Значок з чытальным доступам

Вяртае брэнд з бягучага рахунку з яго ўнутраным ідэнтыфікатарам.

Цяперашняя рэалізацыя вяртае пустую значэнне для невядомага brandId замест HTTP 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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

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

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Стварэнне брэнда

/api/brand

Знак з пісьмовым доступам

Створыць брэнд на бягучым рахунку. імя дастаткова для звычайнай справы.

Назва параўноўваюцца па-неадчувальнаму; Base і base ставяцца да аднаго і таго ж брэнда.

Запытвальны орган

application/json

Поле	Тып	Абавязкова	Апісанне
`name`	string	Так	Унікальнае, не пустае брэнднае імя.
`ozonName`	string	Не	Імя з каталога Озона, калі вядома.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі Ozon, калі карты адпраўляюцца без папярэдняга імпарту.
`oneCId`	string	Не	Стабільны знешні ключ маркі ў 1C.

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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

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

Памылкі6

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

400error_empty_brand_name

Не пазначана назва брэнда

імя не хапае, пустае, або змяшчае толькі белы прастору.

400error_brand_already_exists

Брэнд {name} ужо існуе

У рахунку ўжо ёсць неадчувальная падыход. params.name змяшчае супярэчлівае імя.

400error_subscription_expired

У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Выплаціце тарыф, каб працягваць карыстацца паслугай.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

PUT

Абноўленне брэнда

/api/brand/{brandId}

Знак з пісьмовым доступам

Замяняе рэдагаваць палі брэнда. ID паходзіць з URL; не адпраўляйце brandId ў JSON.

Гэта PUT, таму ўключыце ўсе значэнні, якія трэба захаваць. Пола logo кіруюцца асобнымі канчатковымі пунктамі.

Параметры шляху

Поле	Тып	Абавязкова	Апісанне
`brandId`	integer	Так	Бранд да абнаўлення.

Запытвальны орган

application/json

Поле	Тып	Абавязкова	Апісанне
`name`	string	Так	Новае унікальнае імя.
`deleted`Па змаўчанні: false	boolean	Не	Статус архівавання.
`ozonName`	string	Не	Брэндавая назва ў Озоне.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

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

Памылкі6

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

400error_empty_brand_name

Не пазначана назва брэнда

імя не хапае, пустае, або змяшчае толькі белы прастору.

400error_brand_already_exists

Брэнд {name} ужо існуе

У рахунку ўжо ёсць неадчувальная падыход. params.name змяшчае супярэчлівае імя.

400error_subscription_expired

У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Выплаціце тарыф, каб працягваць карыстацца паслугай.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

DELETE

Знішчыць, архіваваць або аднавіць брэнд

/api/brand/{brandId}

Знак з пісьмовым доступам

З deleted=true, SelSup спрабуе жорсткае выдаленне. Калі спасылкі існуюць, ён архіўвае брэнд замест. deleted = false аднаўляе яго.

Параметры шляху

Поле	Тып	Абавязкова	Апісанне
`brandId`	integer	Так	Ідэнтыфікатар маркі.

Параметры запытаў

Поле	Тып	Абавязкова	Апісанне
`deleted`	boolean	Так	праўда для выдалення або архівавання; непраўда для аднаўлення.

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. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Загрузіць лагатыку

/api/brand/{brandId}/image

Знак з пісьмовым доступам

Загружае малюнак як multipart/form-data. Сучасны лагатып замяняецца.

Паслаць двойны файл у файле; гэты канчатковы пункт не прымае 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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

{
  "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. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

400error_brand_to_found

Брэнд {name} не знойдзены

brandId не існуе ў бягучым рахунку. Дакументацыя захоўвае код error менавіта так, як вярнуўся API.

400error_wrong_image_format

Некарэктны фармат выявы для файла: {name}

Файл не мог быць дэкодаваны ў якасці падтрымліваецца фармат малюнка.

400error_max_upload_size_exceeded

Дапушчальны памер файла перавышаны

Запыт шматдзел перавышае абмежаванне загрузкі сервера.

400error_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	Не	Публічны URL бягучага лагатыку.
`logoSize`	integer	Не	Памер лагаты ў байтах.
`logoWidth`	integer	Не	Шырыня лага ў пікселях.
`logoHeight`	integer	Не	Вышыня лага ў пікселях.
`deleted`Па змаўчанні: false	boolean	Не	Ці будзе марка архівавана.
`ozonName`	string	Не	Назва маркі ў каталогу Ozon.
`ozonId`	integer · int64	Не	Ідэнтыфікатар маркі ў Озоне.
`oneCId`	string	Не	Падключэнне да адзнакі маркі

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

Памылкі7

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

400error_brand_to_found

Брэнд {name} не знойдзены

brandId не існуе ў бягучым рахунку. Дакументацыя захоўвае код error менавіта так, як вярнуўся API.

400error_empty_brand_logo

У брэнда няма выявы

Здалёк лагатыка быў запытаны для брэнда без лагату.

400error_cant_remove_brand_logo

Не атрымліваецца выдаліць выяву брэнда

Захоўванне не магло выдаліць файл або абнавіць запіс брэнда.

400error_subscription_expired

У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Выплаціце тарыф, каб працягваць карыстацца паслугай.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Двухпавярховыя падзелкі

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

Знак з пісьмовым доступам

Пераводзіць мадэлі прадукту ад выдаленняBrandId да brandId, а затым пастаянна выдаляе removeBrandID.

Гэта не можа быць адменена. BrandId захаваўся; выдаліцьBrandId з'яўляецца дублікат, каб выдаліцца.

Параметры шляху

Поле	Тып	Абавязкова	Апісанне
`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. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

400error_brand_not_found

Не знойдзены брэнд: {name}

Адзін з брэндаў, пра які прасілі зліць, не існуе ў бягучым рахунку.

400error_subscription_expired

У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Выплаціце тарыф, каб працягваць карыстацца паслугай.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

Брэды

Готовыя да выкарыстання працоўныя патокі

Знайсці або стварыць брэнд перад стварэннем прадукту

Сінхронізаваць каталог з 1C

Выдаліце дублікат без страты спасылак на прадукт

Полы сапраўды вярнуліся ў Бранд

Як вяртаюць памылкі прыкладання

Канчатковыя пункты

Знайдзіце брэндаў

Параметры запытаў

Удалы адказ

Запіс усіх брэндаў

Удалы адказ

Атрымаць марку па пазначэнні

Параметры шляху

Удалы адказ

Стварэнне брэнда

Запытвальны орган

Удалы адказ

Абноўленне брэнда

Параметры шляху

Запытвальны орган

Удалы адказ

Знішчыць, архіваваць або аднавіць брэнд

Параметры шляху

Параметры запытаў

Удалы адказ

Загрузіць лагатыку

Параметры шляху

Запытвальны орган

Удалы адказ

Знішчыць лагатыку

Параметры шляху

Удалы адказ

Двухпавярховыя падзелкі

Параметры шляху

Удалы адказ

Знак для запытаў на выпрабаванне

Рэальныя параметры запыту

Жывы адказ API