Oʻrnatish

Ishga tayyor ish oqimlari

01

Oʻrnatishlardan foydalanish

API tokenidan foydalaning va avval o'qish operatsiyalarini sinov ma'lumotlari bilan tasdiqlash.

Tokeni server tomoniga saqlang va Authorization boshliqida yuboring.
Kerakli parametrlarni tekshiring va so'rov yoki javob sxemasini kengaytiring.
HTTP holatini va error o'rniga dastur xatolarida ishlash.

PUTMulkni qoʻying GETOʻzingni olib ket GETRo'yxat

Ma'lumotlar modeli

Ma'lumotlar tuzilmalari

Modellari bu yerda bir marta ro'yxatga olingan va ularni ishlatadigan oxirgi nuqtalardan to'g'ridan-to'gʻri kengaytirilishi mumkin.

Property6 maydonlar

organizationIdinteger · int64

Tashkilot identifikatori.

clientIdinteger · int64

Mijozning identifikatori.

read-only

componentstring

Komponent.

namestring

Ism.

valuestring

Qiymat.

valueNamestring

Qiymat nomi.

Xato shartnomasi

Ilovalar xatolarini qaytarib berish usuli

error kodlari har bir joyda bir xil, foydalanuvchiga qaratilgan xabar server tomonidan tarjima qilinadi. error atrofida dastur mantiqasini quring va localMessage-dan faqat ko'rsatish uchun foydalaning.

error

Integratsiya mantiqasini yaratish uchun barqaror mashina o'qiladigan kod.

localMessage

API token foydalanuvchisining tilida ko'rsatishga tayyor xabar.

params

Server tomonidan mahalliylashtirilgan xabar namunalariga interpolatsiya qilingan qiymatlar.

文

localMessage API tokenini egallagan foydalanuvchining lang maydoni ishlatiladi. Hujjat tili va Accept-Language boshliq uni o'zgartirmaydi; foydalanuvchi tilni moslamasa rus tilida ishlatiladigan.

RUFoydalanuvchi manzili ru

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

UZOʻzbekcha (uz)

{
  "error": "error_brand_already_exists",
  "localMessage": "Base brendi allaqachon mavjud",
  "params": {
    "name": "Base"
  }
}

Keyingi nuqtalar

PUT

Mulkni qoʻying

/api/property/

Yozib olish imkoniyatiga ega token

PUT /api/property/. yordamida mulk qoʻyish

Talabnoma organi

application/json

Ob'ekt maydonlariProperty

Maydon	Tur	Majburiy	Tavsif
`organizationId`	integer · int64	Yoʻq	Tashkilot identifikatori.
`clientId`	integer · int64	Yoʻq	Mijozning identifikatori.
`component`	string	Yoʻq	Komponent.
`name`	string	Yoʻq	Ism.
`value`	string	Yoʻq	Qiymat.
`valueName`	string	Yoʻq	Qiymat nomi.

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

Muvaffaqiyatli javob

200

Javobning tanasi yo'q.

Xatolar5

Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑

401auth_required

Tasdiqlash talab etiladi

Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.

400error_access_denied

Kirish taqiqlangan

Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.

500error_unknown

Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing

Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.

400error_invalid_currency_source

Указанный источник курса валют не поддерживается

Uchrashuvda error-dan foydalanish. error_invalid_currency_source kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_no_client

Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

GET

Oʻzingni olib ket

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

Oʻqish imkoniyatiga ega token

GET /api/property/{organizationId}/{component}.dan foydalaning

Yo'l parametrlari

Maydon	Tur	Majburiy	Tavsif
`organizationId`	integer · int64	Ha	Tashkilot identifikatori.
`component`	string	Ha	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());
    }
}

Muvaffaqiyatli javob

200

"string"

Xatolar7

Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑

401auth_required

Tasdiqlash talab etiladi

Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.

400error_access_denied

Kirish taqiqlangan

Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.

500error_unknown

Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing

Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.

400error_header_logo_upload_failed

Could not upload the logo. Please try again.

Uchrashuvda error-dan foydalanish. error_header_logo_upload_failed kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_no_client

Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_ozon_fbo_workflow_not_found

Ozon FBO jarayoni {id} topilmadi

Uchrashuvda error-dan foydalanish. error_ozon_fbo_workflow_not_found kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_user_does_not_have_this_organization

Foydalanuvchi ushbu tashkilotga kirish huquqiga ega emas

Uchrashuvda error-dan foydalanish. error_user_does_not_have_this_organization kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

GET

Ro'yxat

/api/property/list/{component}

Oʻqish imkoniyatiga ega token

GET /api/property/list/{component}. qoʻllanilgan roʻyxat

Yo'l parametrlari

Maydon	Tur	Majburiy	Tavsif
`component`	string	Ha	Komponent.

Soʻrov parametrlari

Maydon	Tur	Majburiy	Tavsif
`organizationId`	integer · int64	Yoʻq	Tashkilot identifikatori.

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

Muvaffaqiyatli javob

200

Array elementining tuzilishi Property[]

Maydon	Tur	Majburiy	Tavsif
`organizationId`	integer · int64	Yoʻq	Tashkilot identifikatori.
`clientId`	integer · int64	Yoʻq	Mijozning identifikatori.
`component`	string	Yoʻq	Komponent.
`name`	string	Yoʻq	Ism.
`value`	string	Yoʻq	Qiymat.
`valueName`	string	Yoʻq	Qiymat nomi.

[
  "string"
]

Xatolar4

Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑

401auth_required

Tasdiqlash talab etiladi

Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.

400error_access_denied

Kirish taqiqlangan

Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.

500error_unknown

Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing

Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.

400error_subscription_expired

У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Uchrashuvda error-dan foydalanish. error_subscription_expired kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

Ishga tayyor ish oqimlari

Oʻrnatishlardan foydalanish

Ma'lumotlar tuzilmalari

Ilovalar xatolarini qaytarib berish usuli

Keyingi nuqtalar

Mulkni qoʻying

Talabnoma organi

Muvaffaqiyatli javob

Oʻzingni olib ket

Yo'l parametrlari

Muvaffaqiyatli javob

Ro'yxat

Yo'l parametrlari

Soʻrov parametrlari

Muvaffaqiyatli javob

Sinov talablari uchun belgisi

Haqiqiy talab parametrlari

API- ning jonli javoblari