API · API Đề xuất

Nhà sản xuất

Các điểm cuối cho các nhà sản xuất, bao gồm các tuyến đường chính xác, các tham số, cơ quan yêu cầu và các chương trình phản ứng có thể mở rộng.

5 điểm cuối/api/manufacturerThường ổn địnhMô tả có thể đọc được bằng máy ↗

{ }

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/manufacturer

Các dòng công việc sẵn sàng sử dụng

Bắt đầu sử dụng Nhà sản xuất

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.

Giữ token bên máy chủ và gửi nó trong tiêu đề Authorization.
Kiểm tra các tham số cần thiết và mở rộng quy trình yêu cầu hoặc phản hồi.
xử lý trạng thái HTTP và trường error ổn định trong lỗi ứng dụng.

GETTìm nhà sản xuất theo ID PUTTạm dịch:DELETETắt nhà sản xuất

Mô hình dữ liệu

Các cấu trúc 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.

Manufacturer11 trường

manufacturerIdinteger · int32

Đơn vị sản xuất

titlestring

Tiêu đề.

namestring

Tên.

Bắt buộc

addressstring

Địa chỉ.

organizationIdinteger · int64

Đơn vị tổ chức.

clientIdinteger · int64

- Đồ nhận khách hàng.

read-only

countryIdinteger · int32

Đơn vị quốc gia.

countryNamestring

Tên quốc gia.

read-only

innstring

Nhà nghỉ.

deletedboolean

- Quá xóa.

oneCIdstring

Một nhân viên.

FindResponseManufacturer1 trường

rowsManufacturer[]

Đường.

Hợp đồng lỗi

Cách trả lại lỗi ứng dụng

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ị.

error

Mã máy tính có thể đọc ổn định cho logic tích hợp.

localMessage

Thô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.

params

Cá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.

RUUser locale là ru

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

VNTiếng Việt (vn)

{
  "error": "error_brand_already_exists",
  "localMessage": "Thương hiệu Base đã tồn tại",
  "params": {
    "name": "Base"
  }
}

Điểm cuối

GET

Tìm nhà sản xuất theo ID

/api/manufacturer/{manufacturerId}

Tấm mã với truy cập đọc

Tìm kiếm Nhà sản xuất theo ID sử dụng GET /api/manufacturer/{manufacturerId}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Có	Đơn vị sản xuất

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

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

Phản ứng thành công

200

Các trường đối tượng Manufacturer

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Không	Đơn vị sản xuất
`title`	string	Không	Tiêu đề.
`name`	string	Có	Tên.
`address`	string	Không	Địa chỉ.
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`clientId`	integer · int64	Không	- Đồ nhận khách hàng.
`countryId`	integer · int32	Không	Đơn vị quốc gia.
`countryName`	string	Không	Tên quốc gia.
`inn`	string	Không	Nhà nghỉ.
`deleted`	boolean	Không	- Quá xóa.
`oneCId`	string	Không	Một nhân viên.

{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}

Hầm lẫn6

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 ↑

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Cá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.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thấ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.

400error_manufacturer_not_found

Không tìm thấy nhà sản xuất: {id}

error cụ thể cho điểm cuối. Sử dụng mã error_manufacturer_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error 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.

400error_subscription_expired

Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error 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.

PUT

Tạm dịch:

/api/manufacturer/{manufacturerId}

Tấm mã với quyền truy cập viết

Cập nhật Nhà sản xuất sử dụng PUT /api/manufacturer/{manufacturerId}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int64	Có	Đơn vị sản xuất

Cơ quan yêu cầu

application/json

Các trường đối tượngManufacturer

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Không	Đơn vị sản xuất
`title`	string	Không	Tiêu đề.
`name`	string	Có	Tên.
`address`	string	Không	Địa chỉ.
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`clientId`	integer · int64	Không	- Đồ nhận khách hàng.
`countryId`	integer · int32	Không	Đơn vị quốc gia.
`countryName`	string	Không	Tên quốc gia.
`inn`	string	Không	Nhà nghỉ.
`deleted`	boolean	Không	- Quá xóa.
`oneCId`	string	Không	Một nhân viên.

curl --request PUT 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

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

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

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/manufacturer/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Example',
        'manufacturerId': 1001,
        'title': 'Example',
        'address': 'string',
        'organizationId': 1001,
        'clientId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
JSON;

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

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Phản ứng thành công

200

Các trường đối tượng Manufacturer

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Không	Đơn vị sản xuất
`title`	string	Không	Tiêu đề.
`name`	string	Có	Tên.
`address`	string	Không	Địa chỉ.
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`clientId`	integer · int64	Không	- Đồ nhận khách hàng.
`countryId`	integer · int32	Không	Đơn vị quốc gia.
`countryName`	string	Không	Tên quốc gia.
`inn`	string	Không	Nhà nghỉ.
`deleted`	boolean	Không	- Quá xóa.
`oneCId`	string	Không	Một nhân viên.

{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}

Hầm lẫn7

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Cá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.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thấ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.

400error_empty_manufacturer_name

Tên nhà sản xuất không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_manufacturer_name ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_manufacturer_already_exist

Đã có nhà sản xuất tên là {name}

error cụ thể cho điểm cuối. Sử dụng mã error_manufacturer_already_exist ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error 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.

400error_subscription_expired

Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error 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.

DELETE

Tắt nhà sản xuất

/api/manufacturer/{manufacturerId}

Tấm mã với quyền truy cập viết

Xóa Nhà sản xuất sử dụng DELETE /api/manufacturer/{manufacturerId}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Có	Đơn vị sản xuất

Các tham số truy vấn

Trường	Loại	Bắt buộc	Mô tả
`deleted`	boolean	Có	- Quá xóa.

curl --request DELETE 'https://api.selsup.ru/api/manufacturer/1001?deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/manufacturer/1001?deleted=false', {
  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/manufacturer/1001?deleted=false', {
  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/manufacturer/1001?deleted=false',
    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/manufacturer/1001?deleted=false',
    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/manufacturer/1001?deleted=false", 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/manufacturer/1001?deleted=false"))
            .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());
    }
}

Phản ứng thành công

200

"string"

Hầm lẫn3

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Cá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.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thấ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.

POST

Tạo nhà sản xuất

/api/manufacturer

Tấm mã với quyền truy cập viết

Tạo Nhà sản xuất sử dụng POST /api/manufacturer.

Cơ quan yêu cầu

application/json

Các trường đối tượngManufacturer

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Không	Đơn vị sản xuất
`title`	string	Không	Tiêu đề.
`name`	string	Có	Tên.
`address`	string	Không	Địa chỉ.
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`clientId`	integer · int64	Không	- Đồ nhận khách hàng.
`countryId`	integer · int32	Không	Đơn vị quốc gia.
`countryName`	string	Không	Tên quốc gia.
`inn`	string	Không	Nhà nghỉ.
`deleted`	boolean	Không	- Quá xóa.
`oneCId`	string	Không	Một nhân viên.

curl --request POST 'https://api.selsup.ru/api/manufacturer' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

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

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/manufacturer', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "manufacturerId": 1001,
    "title": "Example",
    "address": "string",
    "organizationId": 1001,
    "clientId": 1001
  }),
});

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/manufacturer',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Example',
        'manufacturerId': 1001,
        'title': 'Example',
        'address': 'string',
        'organizationId': 1001,
        'clientId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
JSON;

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

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Phản ứng thành công

200

Các trường đối tượng Manufacturer

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Không	Đơn vị sản xuất
`title`	string	Không	Tiêu đề.
`name`	string	Có	Tên.
`address`	string	Không	Địa chỉ.
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`clientId`	integer · int64	Không	- Đồ nhận khách hàng.
`countryId`	integer · int32	Không	Đơn vị quốc gia.
`countryName`	string	Không	Tên quốc gia.
`inn`	string	Không	Nhà nghỉ.
`deleted`	boolean	Không	- Quá xóa.
`oneCId`	string	Không	Một nhân viên.

{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}

Hầm lẫn7

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Cá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.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thấ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.

400error_empty_manufacturer_name

Tên nhà sản xuất không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_manufacturer_name ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_manufacturer_already_exist

Đã có nhà sản xuất tên là {name}

error cụ thể cho điểm cuối. Sử dụng mã error_manufacturer_already_exist ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error 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.

400error_subscription_expired

Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error 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.

GET

Tìm ra

/api/manufacturer/find

Tấm mã với truy cập đọc

Tìm bằng cách sử dụng GET /api/manufacturer/find.

Các tham số truy vấn

Trường	Loại	Bắt buộc	Mô tả
`query`	string	Không	- Tôi hỏi.
`manufacturerOneCId`	string	Không	Nhà sản xuất 1 CId.
`limit`	integer · int32	Không	Giới hạn.
`page`	integer · int32	Không	Page.
`count`	boolean	Không	- Anh đếm.
`sortBy`	stringMANUFACTURERID, NAME	Không	Đặt hàng.
`ascending`	boolean	Không	Tăng lên.

curl --request GET 'https://api.selsup.ru/api/manufacturer/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/manufacturer/find?limit=50&page=1', {
  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/manufacturer/find?limit=50&page=1', {
  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/manufacturer/find?limit=50&page=1',
    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/manufacturer/find?limit=50&page=1',
    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/manufacturer/find?limit=50&page=1", 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/manufacturer/find?limit=50&page=1"))
            .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());
    }
}

Phản ứng thành công

200

Các trường đối tượng FindResponseManufacturer

Trường Loại Bắt buộc Mô tả

rows Manufacturer[] Không Đường.

Cấu trúc của mục array Manufacturer

Trường	Loại	Bắt buộc	Mô tả
`manufacturerId`	integer · int32	Không	Đơn vị sản xuất
`title`	string	Không	Tiêu đề.
`name`	string	Có	Tên.
`address`	string	Không	Địa chỉ.
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`clientId`	integer · int64	Không	- Đồ nhận khách hàng.
`countryId`	integer · int32	Không	Đơn vị quốc gia.
`countryName`	string	Không	Tên quốc gia.
`inn`	string	Không	Nhà nghỉ.
`deleted`	boolean	Không	- Quá xóa.
`oneCId`	string	Không	Một nhân viên.

{
  "rows": "string"
}

Hầm lẫn5

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Cá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.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thấ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.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error 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.

400error_subscription_expired

Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error 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.

Nhà sản xuất

Các dòng công việc sẵn sàng sử dụng

Bắt đầu sử dụng Nhà sản xuất

Các cấu trúc dữ liệu

Cách trả lại lỗi ứng dụng

Điểm cuối

Tìm nhà sản xuất theo ID

Các tham số đường

Phản ứng thành công

Tạm dịch:

Các tham số đường

Cơ quan yêu cầu

Phản ứng thành công

Tắt nhà sản xuất

Các tham số đường

Các tham số truy vấn

Phản ứng thành công

Tạo nhà sản xuất

Cơ quan yêu cầu

Phản ứng thành công

Tìm ra

Các tham số truy vấn

Phản ứng thành công

Tỷ hiệu cho các yêu cầu thử nghiệm

Các tham số yêu cầu thực

Đáp lại API trực tiếp