Өнімді анықтамалық деректер · API Анықтама

Брендтер

Брендтерді құру және табу, Озон мен 1С-ке карта жасау, логотиптерді басқару және дубликаттарды қауіпсіз біріктіру.

9 аяқтық нүктелер/api/brandТұрақтыМашинамен оқитын сипаттама ↗

{ }

SelSup өнімдерінің әрқайсысына бренд қажет. Белгісіз тауарлар үшін алдымен арнайы No brand тіркелгісін құру және оның идентификаторын өнім карталарында қолдану.

/api/brand

Қолдануға дайын жұмыс барысы

Өнімді құрудан бұрын брендті табу немесе құру

Егер тізбе бос болса, брендті құру және өнім картасының брендін сақтау.

GET /api/brand/find сұранысы мен count=true арқылы шақырыңыз.
Өтініштіңде аты-жөнін де ерекшелікпен салыстырып көріңіз.
Егер сәйкестік табылмаса, POST /api/brand дегенді атымен жіберіңіз.
Өнім үлгісін жасау кезінде жауаптан брендId-ді пайдаланыңыз.

GETБрендтерді табу POSTБренд құру

Тіркелмені 1C-мен қадамдастыру

1C кілті бір CId-те сақталып, бүкіл каталогты бір сұраумен жүктеудің орнына беттерді алып кел.

БРАНДИД бойынша сұрыпталған бір мезгілде 50500 жазбаны сұраңыз.
Толық алу үшін бірінші сұрау салуға count=true қойыңыз.
BrandOneCId-тің табылған жетіспейтін жазбаларды немесе жаңартуды құру.

GETБрендтерді табу POSTБренд құру PUTБрендті жаңарту

Өнім сілтемелерін жоғалтпай , көшірмелерді алып тастау

Merge өнім үлгілерін дубликаттан негізгі брендке көшіріп, кейін дубликатты өшіреді.

Екі брендтің бірдейлендіргішін алып, тексеріңіз.
Бастапқы бренд ID-ді тапсырып, қос бренд идентификаторын алып тастаңыз.
Негізгі брендті қайтарып алып, тиісті өнімдерді тексеріңіз.

GETЖеке куәлік бойынша марка алыңыз POSTҚосылу қосарлары

Деректер моделі

Брендтегі Fields қайта оралды

Логотип өрістері суретті жүктегеннен кейін пайда болады. API-ке қатыспайтын ортақ модель өрістерін қасақана қалдырады.

Brand10 өрістер

brandIdinteger

SelSup ағымдағы шотындағы бренд сәйкестендіруші.

read-only

namestring

Марка атауы. Жолдау және артта тұрған орындар сақталған кезде алынып тасталады.

Міндетті

logoUrlstring

Ағымдағы логотиптің қоғамдық URL-сі.

read-only

logoSizeinteger

Логоның өлшемі байтпен.

read-only

logoWidthinteger

Логотиптің ені пиксельдермен.

read-only

logoHeightinteger

Логотиптің биіктігі пиксельдермен.

read-only

deletedboolean

Брендтің мұрағатталғандығы.

ozonNamestring

Озон каталогындағы бренд.

nullable

ozonIdinteger · int64

Озондағы марканы анықтау.

nullable

oneCIdstring

1C-де сыртқы таңба идентификаторы.

nullable

Қате туралы келісімшарт

Қолданба қателерін қайтару

error коды барлық жерлерде бірдей, ал пайдаланушымен бетпе-бет сөйлейтін хабарлама сервер арқылы аударылады. error-ге арналған қолданба логикасын құру және localMessage-ді көрсету үшін ғана пайдалану.

error

Интеграциялық логика үшін тұрақты машина оқуға болатын код.

localMessage

API белгі пайдаланушы тілінде көрсетілуге дайын хабарлама.

params

Сервердің жергілікті хабарлама үлгісіне интерполациялаған мәндері.

文

localMessage API белгісін иеленуші пайдаланушының lang өрісін пайдаланады. Құжаттама тілі мен Accept-Language баған оны өзгертпейді; орыс тілі пайдаланушының тілі конфигурацияланбаған кезде қолданылады.

RUПайдаланушы жері ru

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

KKҚазақша (kk)

{
  "error": "error_brand_already_exists",
  "localMessage": "Base бренді бұрыннан бар",
  "params": {
    "name": "Base"
  }
}

Аяқ нүктелері

GET

Брендтерді табу

/api/brand/find

Оқуға қол жеткізуге мүмкіндік беретін белгі

Тізбе, іздеу және синхронландыру үшін негізгі соңғы нүкте. Ол ағымдағы шоттан брендтерді қайтарады және тұрақты бетін құруды қолдайды.

жалпы саны count=true деген кезде ғана қайтарылады. Келесі беттер үшін count count-ді өшіру.

Сұраныс параметрлері

Өріс	Түрі	Міндетті	Сипаттама
`query`	string	Жоқ	Брендтің атауында іздеуге арналған субстринг.
`deleted`	boolean	Жоқ	Архивтелген үшін дұрыс, белсенді үшін жалған.
`brandOneCId`	string	Жоқ	Шынайы сыртқы 1С идентификаторы.
`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	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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

Қателер3

401auth_required

Құжатты куәландыру қажет

Authorization жоқ, бос немесе жарамсыз белгісі бар.

400error_access_denied

Қолжетімділікке тыйым салынған

Токен бар, бірақ оның рөлі бұл операцияны орындай алмайды.

500error_unknown

Белгісіз қате орын алды. Егер мәселе қайталанса, қолдау қызметіне жазыңыз

Ішкі қате. Сұраныс уақытын және байланыс қолдауын үнемдеу; көзге көрінбейтін түрде қайта сынап көріңіз.

GET

Жеке куәлік бойынша марка алыңыз

/api/brand/{brandId}

Оқуға қол жеткізуге мүмкіндік беретін белгі

Брендтің ішкі идентификаторымен ағымдағы шоттан қайтарылады.

Қазіргі іске асыру HTTP 404 орнына белгісіз брендId үшін бос мәнді қайтарады.

Жол параметрлері

Өріс	Түрі	Міндетті	Сипаттама
`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	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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

Қателер3

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	Жоқ	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	Жоқ	Ағымдағы логотиптің қоғамдық URL-сі.
`logoSize`	integer	Жоқ	Логоның өлшемі байтпен.
`logoWidth`	integer	Жоқ	Логотиптің ені пиксельдермен.
`logoHeight`	integer	Жоқ	Логотиптің биіктігі пиксельдермен.
`deleted`Әдепкі мән: false	boolean	Жоқ	Брендтің мұрағатталғандығы.
`ozonName`	string	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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

Қателер6

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-ден келеді; JSON-те брендId жібермеңіз.

Бұл PUT, сондықтан сақтап қалу үшін барлық мәндерді қосу. Логотип өрістері бөлек ұңғымалар арқылы басқарылады.

Жол параметрлері

Өріс	Түрі	Міндетті	Сипаттама
`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	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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

Қателер6

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}

Жазуға қол жеткізуге мүмкіндік беретін белгі

SelSup-тің "deleted=true" дегенімен қатты өшіруді қолданады. Егер сілтемелер болса, ол брендті мұрағаттап қояды.

Жол параметрлері

Өріс	Түрі	Міндетті	Сипаттама
`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

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	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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

Қателер7

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	Жоқ	Озон каталогындағы бренд.
`ozonId`	integer · int64	Жоқ	Озондағы марканы анықтау.
`oneCId`	string	Жоқ	1C-де сыртқы таңба идентификаторы.

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

Қателер7

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 -ден алып тастаудан алып тастайды, содан кейін BrandId жойылады.

Бұл өзгертілмейді. 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

401auth_required

Құжатты куәландыру қажет

Authorization жоқ, бос немесе жарамсыз белгісі бар.

400error_access_denied

Қолжетімділікке тыйым салынған

Токен бар, бірақ оның рөлі бұл операцияны орындай алмайды.

400error_brand_not_found

Бренд табылмады: {name}

Бірлесуге өтініш берілген брендтердің бірі ағымдағы шотта жоқ.

400error_subscription_expired

Тарифтің қолданылу мерзімі аяқталды. Қызметті пайдалануды жалғастыру үшін тарифті төлеңіз.

Қызметті пайдалану үшін тарифті төлеу.

500error_unknown

Белгісіз қате орын алды. Егер мәселе қайталанса, қолдау қызметіне жазыңыз

Ішкі қате. Сұраныс уақытын және байланыс қолдауын үнемдеу; көзге көрінбейтін түрде қайта сынап көріңіз.

Брендтер

Қолдануға дайын жұмыс барысы

Өнімді құрудан бұрын брендті табу немесе құру

Тіркелмені 1C-мен қадамдастыру

Өнім сілтемелерін жоғалтпай , көшірмелерді алып тастау

Брендтегі Fields қайта оралды

Қолданба қателерін қайтару

Аяқ нүктелері

Брендтерді табу

Сұраныс параметрлері

Жеңіспен жауап

Барлық брендтерді тізімдеңіз

Жеңіспен жауап

Жеке куәлік бойынша марка алыңыз

Жол параметрлері

Жеңіспен жауап

Бренд құру

Өтініш органы

Жеңіспен жауап

Брендті жаңарту

Жол параметрлері

Өтініш органы

Жеңіспен жауап

Брендті өшіру, архивтеу немесе қалпына келтіру

Жол параметрлері

Сұраныс параметрлері

Жеңіспен жауап

Логотипті жүктеу

Жол параметрлері

Өтініш органы

Жеңіспен жауап

Логотипті өшіру

Жол параметрлері

Жеңіспен жауап

Қосылу қосарлары

Жол параметрлері

Жеңіспен жауап

Сынақ өтiнiштерiне арналған белгі

Шын сұраныс параметрлері

Тікелей API жауап