Ürün referans verileri · API İpucu

Markalar

Markalar oluşturun ve bulun, Ozon ve 1C'ye haritasın, logoları yönetin ve kopyaları güvenli bir şekilde birleştirin.

9 Son noktaları/api/brandDayanıklıMakine okuyabilir açıklama ↗

{ }

SelSup'in her ürünü bir marka gerektirir.

/api/brand

Kullanılabilir iş akışları

Bir ürün oluşturmadan önce bir marka bulun veya oluştur

Eğer satır boşsa, marka oluşturun ve ürün kartı için marka ID'yi saklayın.

GET /api/brand/find'i sorgu ve count=true ile çağırın.
Başvuruda isimleri karşılaştır.
Eğer eşleşme bulunmuyorsa POST /api/brand'i isimle gönderin.
Ürün modelini oluştururken yanıttan brandId kullanın.

GETMarkaları bul POSTBir marka oluştur

Dizini 1C ile senkronize edin

1C anahtarını bir birimde tut ve tüm dizinin bir talepte yüklenmesinden ziyade sayfaları getir.

Bir seferde 50 500 kayıt talep edin, BRANDID tarafından sıralamalı.
Toplam almak için ilk talepte count=true ayarlayın.
BrandOneCId tarafından bulunan kayıp kayıtları oluşturun veya güncelleyin.

GETMarkaları bul POSTBir marka oluştur PUTBir marka güncelleme

Ürün bağlantılarını kaybetmeden bir kopya kaldır

Merge ürün modellerini kopyalardan ana marka taşıyor ve ardından kopyaları silmektedir.

İki marka kimliğini de getir ve doğrulay.
Ana marka kimliği geçin ve kopyalar, marka kimliğini kaldırın.
Birincil markayı tekrar getir ve ilgili ürünleri doğrulay.

GETKimlik belgesi ile bir marka al .POSTBirleştirme kopyaları

Verim modeli

Fields aslında Brand'da geri döndü .

Bir resim yüklenmesinden sonra logo alanları görünür. Bu API'e katılmayan paylaşılan model alanları kasten atılır.

Brand10 alanlar

brandIdinteger

SelSup hesabındaki marka kimliği.

read-only

namestring

Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.

Zorunlu

logoUrlstring

Mevcut logoun kamu adresini.

read-only

logoSizeinteger

Logo boyutu baytlarda.

read-only

logoWidthinteger

Logo genişliği piksel olarak.

read-only

logoHeightinteger

Logo yüksekliği piksel olarak.

read-only

deletedboolean

Marka arşivlenmiş mi?

ozonNamestring

Ozon katalogunda marka adı.

nullable

ozonIdinteger · int64

Ozon'da marka kimliği.

nullable

oneCIdstring

1C'deki dış marka kimliği.

nullable

Hata sözleşmesi

Uygulama hataları nasıl iade edilir

error kodu her yerde aynıdır, kullanıcıya yönelik mesaj ise sunucu tarafından tercüme edilir. error etrafında uygulama mantığı oluşturun ve localMessage'i yalnızca görüntülemek için kullanın.

error

Entegre mantığı için sabit makine okunur kod.

localMessage

API token kullanıcısının dilinde görüntülemeye hazır mesaj.

params

Sunucu tarafından yerel mesaj şablonuna girilen değerler.

文

localMessage, API tokenine sahip olan kullanıcının lang alanını kullanır. Belgeleme dili ve Accept-Language başlığı değiştirmez; kullanıcıya dil yapılandırılmadığında Rusça kullanılır.

RUKullanıcı yerel ru

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

TRTürkçe (tr)

{
  "error": "error_brand_already_exists",
  "localMessage": "Base markası zaten mevcut",
  "params": {
    "name": "Base"
  }
}

Son noktaları

GET

Markaları bul

/api/brand/find

Okuma erişimi olan işaret

Liste, arama ve senkronizasyon için ana son noktası.

toplam sadece count=true'da geri gönderilmektedir.

Sorgulama parametreleri

Alan	Tür	Zorunlu	Açıklama
`query`	string	Hayır	Marka adında aramak için alt kat.
`deleted`	boolean	Hayır	Arşivlenmiş için doğru, aktif için yanlış.
`brandOneCId`	string	Hayır	Tam dış 1C kimliği.
`hasOzonId`	boolean	Hayır	Ozon'a gönderilen markaları geri göndermek için doğru.
`limit`Varsayılan değer: 50	integer	Hayır	Sayfa başına kayıtlar, 500'e kadar.
`page`Varsayılan değer: 1	integer	Hayır	Sayfa numarası 1'den başlıyor.
`count`Varsayılan değer: false	boolean	Hayır	Toplamda toplam maç sayısını ekleyin.
`sortBy`	stringNAME, BRANDID	Hayır	Marka adı için İN, iç kimlik için TANK.
`ascending`Varsayılan değer: false	boolean	Hayır	Yukarı çıkmak için doğru, aşağı çıkmak üzere yanlış.

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

Başarılı tepki

200

Alan Tür Zorunlu Açıklama

rows Brand[] Evet Şu anki sayfada markalar.

Array öğesi yapısı Brand

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

totalDurum: count=true integer Hayır Toplam eşleşmeler; sadece count=true olduğunda mevcuttur.

page integer Evet Şu anki sayfa numarası.

hasNextPage boolean Evet başka bir sayfa mevcut olduğunda doğru.

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

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

GET

Tüm markaları listele

/api/brand/all

Okuma erişimi olan işaret

Hesaptaki her markayı isimle sıralar.

Büyük dizinler ve tekrarlı senkronizasyon için, sayfalama ile /find kullanın.

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

Başarılı tepki

200

Array öğesi yapısı Brand[]

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

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

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

GET

Kimlik belgesi ile bir marka al .

/api/brand/{brandId}

Okuma erişimi olan işaret

Bir marka, iç kimliği ile geçerli hesabından geri gönderir.

Geçerli uygulamada HTTP 404 yerine bilinmeyen bir brandId için boş bir değer gönderilmektedir.

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Evet	SelSup'de marka kimliği.

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

Başarılı tepki

200

Nesne alanları Brand

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

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

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

POST

Bir marka oluştur

/api/brand

Yazma erişimli işaretleme

Aktarım hesabında bir marka oluşturur. Adı, sıradan durum için yeterlidir.

Adlar durumlara karşı duyarsız bir şekilde karşılaştırılır; Base ve base aynı marka olarak değerlendirilir.

İstekçi organ

application/json

Alan	Tür	Zorunlu	Açıklama
`name`	string	Evet	Eşsiz, boş olmayan marka adı.
`ozonName`	string	Hayır	Bilinen Ozon dizininden bir isim.
`ozonId`	integer · int64	Hayır	Kartlar önceden ithalat edilmeden gönderildiğinde Ozon marka kimliği.
`oneCId`	string	Hayır	1C'de sabit dış marka anahtarı.

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

Başarılı tepki

200

Nesne alanları Brand

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

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

Hatalar6

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

400error_empty_brand_name

Marka adı belirtilmemiş

isim eksik, boş veya sadece beyaz alan içerir.

400error_brand_already_exists

{name} markası zaten mevcut

Hesap zaten dava karşıtlığıyla uyumlu bir hesapta. params.name, çelişkili bir isim içerir.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

error_subscription_expired'i entegrasyon mantığı için kullanın.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

PUT

Bir marka güncelleme

/api/brand/{brandId}

Yazma erişimli işaretleme

Düzenlenebilir marka alanlarını değiştirir. Kimlik URL'den gelir; JSON'de brandId gönderme.

Bu PUT, bu yüzden korumak için gereken tüm değerleri ekle. Logo alanları ayrı son noktaları tarafından yönetilir.

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Evet	- Yenilik için.

İstekçi organ

application/json

Alan	Tür	Zorunlu	Açıklama
`name`	string	Evet	Yeni bir isim.
`deleted`Varsayılan değer: false	boolean	Hayır	Arşiv durum.
`ozonName`	string	Hayır	Ozon'da marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'de marka kimliği.

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

Başarılı tepki

200

Nesne alanları Brand

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

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

Hatalar6

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

400error_empty_brand_name

Marka adı belirtilmemiş

isim eksik, boş veya sadece beyaz alan içerir.

400error_brand_already_exists

{name} markası zaten mevcut

Hesap zaten dava karşıtlığıyla uyumlu bir hesapta. params.name, çelişkili bir isim içerir.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

error_subscription_expired'i entegrasyon mantığı için kullanın.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

DELETE

Bir marka sil, arşivle veya geri yükle

/api/brand/{brandId}

Yazma erişimli işaretleme

SelSup, deleted=true ile sert bir silme girişiminde bulunur. Eğer referanslar varsa, marka yerine arşivlenir. deleted = false onu geri getirir.

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Evet	Marka kimliği.

Sorgulama parametreleri

Alan	Tür	Zorunlu	Açıklama
`deleted`	boolean	Evet	Silmek veya arşivlemek için doğru; geri getirmek için yanlış.

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

Başarılı tepki

200

brand_has_been_removed

Marka kalıcı olarak silindi.

brand_signed_as_deleted

Referanslar silinmesini engelledi, bu yüzden marka arşivlendirilmişti.

brand_has_been_restore

Markanın arşivden geri getirildi.

"brand_signed_as_deleted"

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

POST

Logo yükle

/api/brand/{brandId}/image

Yazma erişimli işaretleme

Bir görüntü multipart/form-data. olarak yükler.

İkili dosyayı dosya olarak gönderin; bu uç noktası JSON'i kabul etmez.

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Evet	Marka kimliği.

İstekçi organ

multipart/form-data

Alan	Tür	Zorunlu	Açıklama
`file`	binary	Evet	Desteklenen bir biçimdeki görüntü dosyası.

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

Başarılı tepki

200

Nesne alanları Brand

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

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

Hatalar7

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

400error_brand_to_found

{name} markası bulunamadı

brandId geçerli hesabda bulunmuyor.Dokumentasyon error kodunu API tarafından gönderilen şekilde koruyor.

400error_wrong_image_format

Dosya için hatalı resim formatı: {name}

Dosya desteklenen bir görüntü biçimi olarak çözülemedi.

400error_max_upload_size_exceeded

İzin verilen dosya boyutu aşıldı

Çok bölümlü talep sunucu yükleme sınırını aşar.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

error_subscription_expired'i entegrasyon mantığı için kullanın.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

DELETE

Logo sil

/api/brand/{brandId}/image

Yazma erişimli işaretleme

Logo dosyasını siler ve marka kayıtlarında boyutlarını yeniden ayarlar.

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Evet	Marka kimliği.

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

Başarılı tepki

200

Nesne alanları Brand

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Hayır	SelSup hesabındaki marka kimliği.
`name`	string	Evet	Marka adı. Ön ve arka boşluklar kaydedildiğinde kaldırılır.
`logoUrl`	string	Hayır	Mevcut logoun kamu adresini.
`logoSize`	integer	Hayır	Logo boyutu baytlarda.
`logoWidth`	integer	Hayır	Logo genişliği piksel olarak.
`logoHeight`	integer	Hayır	Logo yüksekliği piksel olarak.
`deleted`Varsayılan değer: false	boolean	Hayır	Marka arşivlenmiş mi?
`ozonName`	string	Hayır	Ozon katalogunda marka adı.
`ozonId`	integer · int64	Hayır	Ozon'da marka kimliği.
`oneCId`	string	Hayır	1C'deki dış marka kimliği.

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

Hatalar7

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

400error_brand_to_found

{name} markası bulunamadı

brandId geçerli hesabda bulunmuyor.Dokumentasyon error kodunu API tarafından gönderilen şekilde koruyor.

400error_empty_brand_logo

Markanın görseli yok

Logo olmadan bir marka için logo silinmesi istendi.

400error_cant_remove_brand_logo

Marka logosu silinemiyor

Kayıt dosyayı silemiyor veya marka kayıtlarını güncelleyemiyor.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

error_subscription_expired'i entegrasyon mantığı için kullanın.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

POST

Birleştirme kopyaları

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

Yazma erişimli işaretleme

Ürün modellerini BrandId'i BrandId kaldırmaktan BrandId 'e taşıyor, ardından BrandId silmeyi kalıcı olarak silmektedir.

Bu iptal edilemez. BrandId saklanır; kaldır BrandId kaldırılacak kopya.

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`brandId`	integer	Evet	Ana marka kimliği.
`removeBrandId`	integer	Evet	Silmek için ikili marka kimliği.

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

Başarılı tepki

200

Cevapın bir vücudu yok.

Hatalar5

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

400error_brand_not_found

Marka bulunamadı: {name}

Birleştirme için talep edilen markalardan biri geçerli hesabda bulunmuyor.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

error_subscription_expired'i entegrasyon mantığı için kullanın.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

Markalar

Kullanılabilir iş akışları

Bir ürün oluşturmadan önce bir marka bulun veya oluştur

Dizini 1C ile senkronize edin

Ürün bağlantılarını kaybetmeden bir kopya kaldır

Fields aslında Brand'da geri döndü .

Uygulama hataları nasıl iade edilir

Son noktaları

Markaları bul

Sorgulama parametreleri

Başarılı tepki

Tüm markaları listele

Başarılı tepki

Kimlik belgesi ile bir marka al .

Yol parametreleri

Başarılı tepki

Bir marka oluştur

İstekçi organ

Başarılı tepki

Bir marka güncelleme

Yol parametreleri

İstekçi organ

Başarılı tepki

Bir marka sil, arşivle veya geri yükle

Yol parametreleri

Sorgulama parametreleri

Başarılı tepki

Logo yükle

Yol parametreleri

İstekçi organ

Başarılı tepki

Logo sil

Yol parametreleri

Başarılı tepki

Birleştirme kopyaları

Yol parametreleri

Başarılı tepki

Test istekleri için işaret

Gerçek talep parametreleri

Canlı API tepkisi