Ayarlar

Kullanılabilir iş akışları

01

Ayarları kullanmaya başlayın

Özel bir API token kullanın ve önce test verileri ile okuma işlemlerini doğrulayın.

Token sunucu tarafında tut ve Authorization başlığı gönder.
Gerekli parametreleri kontrol edin ve istek veya yanıt şeması genişletin.
Uygulama hatalarında HTTP durumunu ve sabit error alanını ele alın.

PUTMülkiyetinizi Verin GETAl bakalım.GETListe

Verim modeli

Veriler yapısı

Modeller burada bir kez listelenmiştir ve bunları kullanan uç noktalardan doğrudan genişletilebilir.

Property6 alanlar

organizationIdinteger · int64

Teşkilat Kimliği.

clientIdinteger · int64

Müşteri kimliği.

read-only

componentstring

- Komponent.

namestring

Adı.

valuestring

Değer.

valueNamestring

Değer Adı.

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ı

PUT

Mülkiyetinizi Verin

/api/property/

Yazma erişimli işaretleme

PUT /api/property/. kullanarak Mülkiyet koy

İstekçi organ

application/json

Nesne alanlarıProperty

Alan	Tür	Zorunlu	Açıklama
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.
`clientId`	integer · int64	Hayır	Müşteri kimliği.
`component`	string	Hayır	- Komponent.
`name`	string	Hayır	Adı.
`value`	string	Hayır	Değer.
`valueName`	string	Hayır	Değer Adı.

curl --request PUT 'https://api.selsup.ru/api/property/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "organizationId": 1001,
  "clientId": 1001,
  "component": "string",
  "name": "Example",
  "value": "string",
  "valueName": "Example"
}'

const response = await fetch('https://api.selsup.ru/api/property/', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "organizationId": 1001,
    "clientId": 1001,
    "component": "string",
    "name": "Example",
    "value": "string",
    "valueName": "Example"
  }),
});

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/property/', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "organizationId": 1001,
    "clientId": 1001,
    "component": "string",
    "name": "Example",
    "value": "string",
    "valueName": "Example"
  }),
});

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.put(
    'https://api.selsup.ru/api/property/',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'organizationId': 1001,
        'clientId': 1001,
        'component': 'string',
        'name': 'Example',
        'value': 'string',
        'valueName': 'Example'
    },
)
response.raise_for_status()

<?php

$payload = <<<'JSON'
{
  "organizationId": 1001,
  "clientId": 1001,
  "component": "string",
  "name": "Example",
  "value": "string",
  "valueName": "Example"
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/property/',
    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/property/", strings.NewReader(`{
  "organizationId": 1001,
  "clientId": 1001,
  "component": "string",
  "name": "Example",
  "value": "string",
  "valueName": "Example"
}`))
    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/property/"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "organizationId": 1001,
  "clientId": 1001,
  "component": "string",
  "name": "Example",
  "value": "string",
  "valueName": "Example"
}
"""))
            .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.

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.

400error_invalid_currency_source

Belirtilen dÃ¶viz kuru kaynaÄÄ± desteklenmiyor

Uygulama mantığında sabit error_invalid_currency_source kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client

Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

Al bakalım.

/api/property/{organizationId}/{component}

Okuma erişimi olan işaret

GET /api/property/{organizationId}/{component}. kullanın

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`organizationId`	integer · int64	Evet	Teşkilat Kimliği.
`component`	string	Evet	- Komponent.

curl --request GET 'https://api.selsup.ru/api/property/1001/string' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/property/1001/string', {
  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/property/1001/string', {
  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/property/1001/string',
    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/property/1001/string',
    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/property/1001/string", 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/property/1001/string"))
            .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

"string"

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.

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.

400error_header_logo_upload_failed

Could not upload the logo. Please try again.

Uygulama mantığında sabit error_header_logo_upload_failed kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client

Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_ozon_fbo_workflow_not_found

Ozon FBO iş akışı {id} bulunamadı

Uygulama mantığında sabit error_ozon_fbo_workflow_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_user_does_not_have_this_organization

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

Uygulama mantığında sabit error_user_does_not_have_this_organization kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

Liste

/api/property/list/{component}

Okuma erişimi olan işaret

GET /api/property/list/{component}. kullanan liste

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`component`	string	Evet	- Komponent.

Sorgulama parametreleri

Alan	Tür	Zorunlu	Açıklama
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.

curl --request GET 'https://api.selsup.ru/api/property/list/string' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/property/list/string', {
  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/property/list/string', {
  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/property/list/string',
    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/property/list/string',
    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/property/list/string", 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/property/list/string"))
            .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ı Property[]

Alan	Tür	Zorunlu	Açıklama
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.
`clientId`	integer · int64	Hayır	Müşteri kimliği.
`component`	string	Hayır	- Komponent.
`name`	string	Hayır	Adı.
`value`	string	Hayır	Değer.
`valueName`	string	Hayır	Değer Adı.

[
  "string"
]

Hatalar4

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.

400error_subscription_expired

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

Uygulama mantığında sabit error_subscription_expired kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

Kullanılabilir iş akışları

Ayarları kullanmaya başlayın

Veriler yapısı

Uygulama hataları nasıl iade edilir

Son noktaları

Mülkiyetinizi Verin

İstekçi organ

Başarılı tepki

Al bakalım.

Yol parametreleri

Başarılı tepki

Liste

Yol parametreleri

Sorgulama parametreleri

Başarılı tepki

Test istekleri için işaret

Gerçek talep parametreleri

Canlı API tepkisi