Dane referencyjne dotyczące produktu · API Referencja

Brandy

Tworzyć i znaleźć marki, wykorzystać je w Ozon i 1C, zarządzać logo i bezpiecznie łączyć kopie.

9 punkty końcowe/api/brandStabilnyOpis czytelny maszynowo ↗

{ }

W przypadku produktów bez marki najpierw utwórz specjalny rekord No brand i użyj jego identyfikatora w kartkach produktu.

/api/brand

Gotowe do użytkowania przepływy robocze

Znajdź lub utwórz markę przed utworzeniem produktu

Jeśli wiersze są puste, utwórz markę i przechowuj markId karty produktu.

Zadzwoń do GET /api/brand/find z zapytaniem i count=true.
Porównaj w swoim wniosku niewrażliwie w przypadku nazwy.
Jeśli nie ma dopasowania, wysłać POST /api/brand z nazwą.
Użyj znaczki od odpowiedzi podczas tworzenia modelu produktu.

GETZnajdź marki POSTTworzyć markę

Synchronizować katalog z 1C

Trzymaj klucz 1C w jednym CD i przybierz strony zamiast ładować cały katalog w jednym żądanie.

Zwróć się o 50500 zapisów raz na raz, zorganizowane przez BRANDID.
Ustaw liczbę = prawdziwą na pierwszym wniosku o otrzymanie całkowitej liczby.
Tworzenie brakujących rekordów lub aktualizacja dopasowań znalezionych przez brandOneCId.

GETZnajdź marki POSTTworzyć markę PUTAktualizacja marki

Usunięcie kopii bez utraty linków do produktu

W przypadku wprowadzania do obrotu w ramach programu "Ferge" model produktu z duplikatu do marki podstawowej, a następnie usunięcie duplikacji nie może być odwołane.

Przyprowadź i sprawdź oba identyfikatory marki.
Przekaż pierwotny znak i usunąć duplikat.
Przyprowadź znów podstawową markę i sprawdź związane produkty.

GETZnajdź znaczkę po identyfikacji POSTDupulikacje fuzji

Model danych

/Płasy rzeczywiście wróciły w Brand

Po przesłaniu obrazu pojawiają się pola logo. Pola z modelów udostępnionych, które nie uczestniczą w API, są celowo pominięte.

Brand10 pola

brandIdinteger

identyfikator marki w bieżącym rachunku SelSup.

read-only

namestring

Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.

Wymagane

logoUrlstring

Publiczny adres URL aktualnego logo.

read-only

logoSizeinteger

Rozmiar logo w bajtów.

read-only

logoWidthinteger

Szerokość logo w pikselach.

read-only

logoHeightinteger

Wysokość logo w pikselach.

read-only

deletedboolean

Czy marka jest archiwizowana.

ozonNamestring

Nazwa marki w katalogu Ozon.

nullable

ozonIdinteger · int64

Identyfikacja marki w Ozon.

nullable

oneCIdstring

Zewnętrzny identyfikator marki w 1C.

nullable

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

文

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru

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

PLPolski (pl)

{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

GET

Znajdź marki

/api/brand/find

Token z dostępem do odczytu

Główny punkt końcowy dla list, wyszukiwania i synchronizacji.

całkowita jest zwrócona tylko w przypadku liczby=prawda. Wyłącz liczbę dla kolejnych stron.

Parametry zapytania

Pole	Typ	Wymagane	Opis
`query`	string	Nie	Podstrona do wyszukiwania w nazwie marki.
`deleted`	boolean	Nie	Prawda na archiwizację, fałszywa na aktywność.
`brandOneCId`	string	Nie	Dokładny zewnętrzny identyfikator 1C.
`hasOzonId`	boolean	Nie	Prawdziwy do zwrotu tylko marki z Ozon.
`limit`Wartość domyślna: 50	integer	Nie	Rekordy na stronę, do 500.
`page`Wartość domyślna: 1	integer	Nie	Numer strony zaczyna się od 1.
`count`Wartość domyślna: false	boolean	Nie	Włączyć łącznie łączną liczbę dopasowań.
`sortBy`	stringNAME, BRANDID	Nie	NAWÓWKA dla nazwy marki, BRANDID dla identyfikatora wewnętrznego.
`ascending`Wartość domyślna: false	boolean	Nie	Prawda jest prawdziwa, a nie prawda jest prawdziwy.

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());
    }
}

Odpowiedź udana

200

Pole Typ Wymagane Opis

rows Brand[] Tak Marki na bieżącej stronie.

Struktura pozycji zestawu Brand

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

totalWarunki: count=true integer Nie Całkowita dopasowań; obecna tylko w przypadku liczby=prawda.

page integer Tak Numer aktualnej strony.

hasNextPage boolean Tak Prawda, gdy jest dostępna inna strona.

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

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Wykaz wszystkich marek

/api/brand/all

Token z dostępem do odczytu

Wraca każdą markę na konto, zorganizowaną po imieniu.

W przypadku dużych katalogów i powtarzających się synchronizacji użyj /find z pagination.

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());
    }
}

Odpowiedź udana

200

Struktura pozycji zestawu Brand[]

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

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

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Znajdź znaczkę po identyfikacji

/api/brand/{brandId}

Token z dostępem do odczytu

Wynosi markę z rachunku bieżącego za pomocą wewnętrznego identyfikatora.

Aktualna implementacja zwraca puste wartości dla nieznanego znaku identyfikacji marki zamiast HTTP 404.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`brandId`	integer	Tak	identyfikator marki w 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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Brand

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

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

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

POST

Tworzyć markę

/api/brand

Token z dostępem do pisania

Tworzy markę na rachunku bieżącym. Nazwa wystarczy do zwykłego przypadku.

Nazwa jest porównywana w sposób niewrażliwy na przypadki; Base i base są traktowane jako ta sama marka.

Organ wnioskujący

application/json

Pole	Typ	Wymagane	Opis
`name`	string	Tak	Unikalna, nieprzerwana marka.
`ozonName`	string	Nie	Nazwa z katalogu Ozon, jeśli jest znana.
`ozonId`	integer · int64	Nie	identyfikacja marki Ozon, gdy karty są wysyłane bez uprzedniego importu.
`oneCId`	string	Nie	Stabilny klucz zewnętrzny w 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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Brand

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

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

Władze6

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

400error_empty_brand_name

Nie podano nazwy marki

nie ma nazwy, jest pusta lub zawiera tylko białą przestrzeń.

400error_brand_already_exists

Marka {name} już istnieje

Nazwa params.name zawiera sprzeczne nazwy.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

Zapłacić taryfy, aby kontynuować korzystanie z usługi.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

PUT

Aktualizacja marki

/api/brand/{brandId}

Token z dostępem do pisania

Odpowiada się na adres URL, nie wysyłaj brandydu w JSON.

To jest PUT, więc włącz wszystkie wartości, które musisz zachować. Pola logo są zarządzane przez oddzielne punkty końcowe.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`brandId`	integer	Tak	Znak do aktualizacji.

Organ wnioskujący

application/json

Pole	Typ	Wymagane	Opis
`name`	string	Tak	Nowy wyjątkowy nazwa.
`deleted`Wartość domyślna: false	boolean	Nie	Archiwizowany status.
`ozonName`	string	Nie	Nazwa marki w Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	identyfikator marki w 1C.

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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Brand

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

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

Władze6

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

400error_empty_brand_name

Nie podano nazwy marki

nie ma nazwy, jest pusta lub zawiera tylko białą przestrzeń.

400error_brand_already_exists

Marka {name} już istnieje

Nazwa params.name zawiera sprzeczne nazwy.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

Zapłacić taryfy, aby kontynuować korzystanie z usługi.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

DELETE

Usuwanie, archiwizacja lub przywrócenie marki

/api/brand/{brandId}

Token z dostępem do pisania

W przypadku wymażonego=prawdziwego SelSup próbuje wymazać. Jeśli istnieją odniesienia, zamiast tego archiwizuje markę. wymażona=fałszywa przywraca ją.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`brandId`	integer	Tak	Identyfikacja marki.

Parametry zapytania

Pole	Typ	Wymagane	Opis
`deleted`	boolean	Tak	Prawda do usunięcia lub archiwizacji; fałszywa do przywrócenia.

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());
    }
}

Odpowiedź udana

200

brand_has_been_removed

Marka została trwale usunięta.

brand_signed_as_deleted

Referencje uniemożliwiały usunięcie, więc marka została archiwowana.

brand_has_been_restore

Marka została odzyskana z archiwum.

"brand_signed_as_deleted"

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

POST

Wstąpienie logo

/api/brand/{brandId}/image

Token z dostępem do pisania

Władza obraz jako multipart/form-data. Zastąpione jest istniejące logo.

Wysyłać plik binarny w pliku; ten punkt końcowy nie akceptuje JSON.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`brandId`	integer	Tak	Identyfikacja marki.

Organ wnioskujący

multipart/form-data

Pole	Typ	Wymagane	Opis
`file`	binary	Tak	Plik obrazu w obsługiwanym formie.

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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Brand

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

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

Władze7

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

400error_brand_to_found

Marka {name} nie znaleziona

Dokumenty zachowują kod error dokładnie tak, jak został zwrócony przez API.

400error_wrong_image_format

Nieprawidłowy format obrazu dla pliku: {name}

Plik nie mógł być dekodowany jako wspierany format obrazu.

400error_max_upload_size_exceeded

Dopuszczalny rozmiar pliku przekroczony

Wniosek z wieloczęściowym przesyłaniem przekracza limit przesyłu serwera.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

Zapłacić taryfy, aby kontynuować korzystanie z usługi.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

DELETE

Usunięcie logo

/api/brand/{brandId}/image

Token z dostępem do pisania

Usuwa plik logo i ustawia jego wymiary w rekordzie marki.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`brandId`	integer	Tak	Identyfikacja marki.

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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Brand

Pole	Typ	Wymagane	Opis
`brandId`	integer	Nie	identyfikator marki w bieżącym rachunku SelSup.
`name`	string	Tak	Nazwa marki, przestrzenie prowadzące i pozostałe są usuwane, gdy są zapisane.
`logoUrl`	string	Nie	Publiczny adres URL aktualnego logo.
`logoSize`	integer	Nie	Rozmiar logo w bajtów.
`logoWidth`	integer	Nie	Szerokość logo w pikselach.
`logoHeight`	integer	Nie	Wysokość logo w pikselach.
`deleted`Wartość domyślna: false	boolean	Nie	Czy marka jest archiwizowana.
`ozonName`	string	Nie	Nazwa marki w katalogu Ozon.
`ozonId`	integer · int64	Nie	Identyfikacja marki w Ozon.
`oneCId`	string	Nie	Zewnętrzny identyfikator marki w 1C.

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

Władze7

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

400error_brand_to_found

Marka {name} nie znaleziona

Dokumenty zachowują kod error dokładnie tak, jak został zwrócony przez API.

400error_empty_brand_logo

Marka nie ma obrazu

Wniosek o usunięcie logo został złożony w przypadku marki bez logo.

400error_cant_remove_brand_logo

Nie można usunąć obrazu marki

Przechowywanie nie mogło usunąć pliku ani aktualizować zapisu marki.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

Zapłacić taryfy, aby kontynuować korzystanie z usługi.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

POST

Dupulikacje fuzji

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

Token z dostępem do pisania

Przenosi modele produktu z usunięcia BrandId do BrandId, a następnie trwale usuwa usuniąć BrandId.

Nie można tego odwrócić. identyfikacja marki jest zachowana; usunięcie.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`brandId`	integer	Tak	Pierwsza identyfikacja marki.
`removeBrandId`	integer	Tak	/Duplikowany identyfikator marki /do usunięcia.

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());
    }
}

Odpowiedź udana

200

Odpowiedź nie ma ciała.

Władze5

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

400error_brand_not_found

Nie znaleziono marki: {name}

Jedna z marek, o którą wnioskowano o połączenie, nie istnieje na rachunku bieżącym.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

Zapłacić taryfy, aby kontynuować korzystanie z usługi.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

Brandy

Gotowe do użytkowania przepływy robocze

Znajdź lub utwórz markę przed utworzeniem produktu

Synchronizować katalog z 1C

Usunięcie kopii bez utraty linków do produktu

/Płasy rzeczywiście wróciły w Brand

W jaki sposób można zwrócić błędy w aplikacji

Punkty końcowe

Znajdź marki

Parametry zapytania

Odpowiedź udana

Wykaz wszystkich marek

Odpowiedź udana

Znajdź znaczkę po identyfikacji

Parametry ścieżki

Odpowiedź udana

Tworzyć markę

Organ wnioskujący

Odpowiedź udana

Aktualizacja marki

Parametry ścieżki

Organ wnioskujący

Odpowiedź udana

Usuwanie, archiwizacja lub przywrócenie marki

Parametry ścieżki

Parametry zapytania

Odpowiedź udana

Wstąpienie logo

Parametry ścieżki

Organ wnioskujący

Odpowiedź udana

Usunięcie logo

Parametry ścieżki

Odpowiedź udana

Dupulikacje fuzji

Parametry ścieżki

Odpowiedź udana

Token do wniosków o badania

Prawdziwe parametry żądania

Odpowiedź API