SelSup Developers
API · API Đề xuất
Endpoints for Settings, bao gồm các tuyến đường chính xác, các tham số, các cơ quan yêu cầu và các chương trình phản hồi có thể mở rộng.
Trang này được hỗ trợ bởi một hợp đồng độc lập có thể chỉnh sửa. Thiết lập các hoạt động viết bằng dữ liệu thử nghiệm trước khi sử dụng sản xuất.
/api/property
Các dòng công việc sẵn sàng sử dụng
Sử dụng mã thông báo API chuyên dụng và xác nhận các hoạt động đọc bằng dữ liệu thử nghiệm trước.
Mô hình dữ liệu
Các mô hình được liệt kê một lần ở đây và cũng có thể được mở rộng trực tiếp từ các điểm cuối sử dụng chúng.
organizationIdinteger · int64Đơn vị tổ chức.
clientIdinteger · int64- Đồ nhận khách hàng.
read-onlycomponentstringPhần.
namestringTên.
valuestringGiá trị.
valueNamestringTên giá trị.
Hợp đồng lỗi
Mã error giống nhau ở mọi địa điểm, trong khi thông điệp đối diện người dùng được dịch bởi máy chủ. Xây dựng logic ứng dụng xung quanh error và sử dụng localMessage chỉ cho hiển thị.
errorMã máy tính có thể đọc ổn định cho logic tích hợp.
localMessageThông điệp sẵn sàng hiển thị trong ngôn ngữ của người dùng mã thông báo API.
paramsCác giá trị được máy chủ liên kết vào mẫu tin nhắn địa phương.
localMessage sử dụng trường lang của người dùng sở hữu mã thông báo API. Ngôn ngữ tài liệu và tiêu đề Accept-Language không thay đổi nó; tiếng Nga được sử dụng khi người dùng không có ngôn ngữ được cấu hình.
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}{
"error": "error_brand_already_exists",
"localMessage": "Thương hiệu Base đã tồn tại",
"params": {
"name": "Base"
}
}Điểm cuối
/api/property/Đặt Tài sản bằng PUT /api/property/.
application/jsonProperty| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
organizationId |
integer · int64 | Không | Đơn vị tổ chức. |
clientId |
integer · int64 | Không | - Đồ nhận khách hàng. |
component |
string | Không | Phần. |
name |
string | Không | Tên. |
value |
string | Không | Giá trị. |
valueName |
string | Không | Tên giá trị. |
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());
}
}Phản ứng không có cơ thể.
Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑
auth_requiredAuthorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.
error_access_deniedCác token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.
error_unknownThất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.
error_invalid_currency_sourceerror cụ thể cho điểm cuối. Sử dụng mã error_invalid_currency_source ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.
error_no_clienterror cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.
/api/property/{organizationId}/{component}Sử dụng GET /api/property/{organizationId}/{component}.
| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
organizationId |
integer · int64 | Có | Đơn vị tổ chức. |
component |
string | Có | Phần. |
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());
}
}"string"Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑
auth_requiredAuthorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.
error_access_deniedCác token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.
error_unknownThất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.
error_header_logo_upload_failederror cụ thể cho điểm cuối. Sử dụng mã error_header_logo_upload_failed ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.
error_no_clienterror cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.
error_ozon_fbo_workflow_not_founderror cụ thể cho điểm cuối. Sử dụng mã error_ozon_fbo_workflow_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.
error_user_does_not_have_this_organizationerror cụ thể cho điểm cuối. Sử dụng mã error_user_does_not_have_this_organization ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.
/api/property/list/{component}Danh sách sử dụng GET /api/property/list/{component}.
| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
component |
string | Có | Phần. |
| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
organizationId |
integer · int64 | Không | Đơn vị tổ chức. |
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());
}
}Property[]
| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
organizationId |
integer · int64 | Không | Đơn vị tổ chức. |
clientId |
integer · int64 | Không | - Đồ nhận khách hàng. |
component |
string | Không | Phần. |
name |
string | Không | Tên. |
value |
string | Không | Giá trị. |
valueName |
string | Không | Tên giá trị. |
[
"string"
]Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑
auth_requiredAuthorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.
error_access_deniedCác token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.
error_unknownThất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.
error_subscription_expirederror cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.