Gióp

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

01

Bắt đầu sử dụng Job

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.

PUTĐặt công việc DELETETắt đi Job POSTCông việc sau

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.

Job11 trường

idinteger · int32

Id.

namestring

Tên.

categoryClassstring

Nhóm hạng mục.

clientIdinteger · int64

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

deletedboolean

- Quá xóa.

positionIdinteger · int64

Đơn vị ID.

versionIdinteger · int64

Phiên bản ID.

createdUserstring

Tạo User.

createdDatestring · date-time

Ngày được tạo ra.

pricenumber · double

Giá cả.

tariffsJobTariff[]

Thuế thuế quan.

JobTariff8 trường

idinteger · int64

Id.

jobIdinteger · int32

Đồ nhận công việc.

pricenumber · double

Giá cả.

brandIdinteger · int32

Đơn vị thương hiệu.

categoryClassstring

Nhóm hạng mục.

categoryIdinteger · int32

Phân loại ID.

priorityinteger · int32

Tự ưu tiên.

productIdinteger · int64

Đơn vị sản phẩm

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

PUT

Đặt công việc

/api/job/{jobId}

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

Đặt Job bằng PUT /api/job/{jobId}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`jobId`	integer · int64	Có	Đồ nhận công việc.

Cơ quan yêu cầu

application/json

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

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

id integer · int32 Không Id.

name string Không Tên.

categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Nhóm hạng mục.

clientId integer · int64 Không - Đồ nhận khách hàng.

deleted boolean Không - Quá xóa.

positionId integer · int64 Không Đơn vị ID.

versionId integer · int64 Không Phiên bản ID.

createdUser string Không Tạo User.

createdDate string · date-time Không Ngày được tạo ra.

price number · double Không Giá cả.

tariffs JobTariff[] Không Thuế thuế quan.

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

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int64	Không	Id.
`jobId`	integer · int32	Không	Đồ nhận công việc.
`price`	number · double	Không	Giá cả.
`brandId`	integer · int32	Không	Đơn vị thương hiệu.
`categoryClass`	stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS	Không	Nhóm hạng mục.
`categoryId`	integer · int32	Không	Phân loại ID.
`priority`	integer · int32	Không	Tự ưu tiên.
`productId`	integer · int64	Không	Đơn vị sản phẩm

curl --request PUT 'https://api.selsup.ru/api/job/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/job/1001', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "categoryClass": "SHOES",
    "clientId": 1001,
    "deleted": false,
    "positionId": 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/job/1001', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "categoryClass": "SHOES",
    "clientId": 1001,
    "deleted": false,
    "positionId": 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/job/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'id': 1001,
        'name': 'Example',
        'categoryClass': 'SHOES',
        'clientId': 1001,
        'deleted': False,
        'positionId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/job/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/job/1001", strings.NewReader(`{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 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/job/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 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 Job

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

id integer · int32 Không Id.

name string Không Tên.

categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Nhóm hạng mục.

clientId integer · int64 Không - Đồ nhận khách hàng.

deleted boolean Không - Quá xóa.

positionId integer · int64 Không Đơn vị ID.

versionId integer · int64 Không Phiên bản ID.

createdUser string Không Tạo User.

createdDate string · date-time Không Ngày được tạo ra.

price number · double Không Giá cả.

tariffs JobTariff[] Không Thuế thuế quan.

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

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int64	Không	Id.
`jobId`	integer · int32	Không	Đồ nhận công việc.
`price`	number · double	Không	Giá cả.
`brandId`	integer · int32	Không	Đơn vị thương hiệu.
`categoryClass`	stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS	Không	Nhóm hạng mục.
`categoryId`	integer · int32	Không	Phân loại ID.
`priority`	integer · int32	Không	Tự ưu tiên.
`productId`	integer · int64	Không	Đơn vị sản phẩm

{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 1001
}

Hầm lẫn14

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_empty_category_class

Lớp không được chỉ định

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

400error_empty_job_price

Giá cho công việc không được chỉ định

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

400error_empty_position

Vị trí không được chỉ định

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

400error_empty_tariff_price

Giá không được chỉ định cho biểu giá{position}

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

400error_empty_tariff_priority

Không có ưu tiên nào được chỉ định cho biểu thuế số{position}

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

400error_empty_tariffs

Thuế quan không được chỉ định

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

400error_job_already_exists

Công việc có tên {jobName} đã tồn tại

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

400error_job_modified

Chi tiết công việc đã được cập nhật. Làm mới trang.

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

400error_job_tariff_wrong_product_id

Số nhận dạng sản phẩm không chính xác: {id}

error cụ thể cho điểm cuối. Sử dụng mã error_job_tariff_wrong_product_id ổ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 đi Job

/api/job/{jobId}

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

Xóa Job bằng cách sử dụng DELETE /api/job/{jobId}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`jobId`	integer · int32	Có	Đồ nhận công việc.

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/job/1001?deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/job/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/job/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/job/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/job/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/job/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/job/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ẫ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_job_modified

Chi tiết công việc đã được cập nhật. Làm mới trang.

error cụ thể cho điểm cuối. Sử dụng mã error_job_modified ổ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.

POST

Công việc sau

/api/job/

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

Post Job sử dụng POST /api/job/.

Cơ quan yêu cầu

application/json

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

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

id integer · int32 Không Id.

name string Không Tên.

categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Nhóm hạng mục.

clientId integer · int64 Không - Đồ nhận khách hàng.

deleted boolean Không - Quá xóa.

positionId integer · int64 Không Đơn vị ID.

versionId integer · int64 Không Phiên bản ID.

createdUser string Không Tạo User.

createdDate string · date-time Không Ngày được tạo ra.

price number · double Không Giá cả.

tariffs JobTariff[] Không Thuế thuế quan.

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

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int64	Không	Id.
`jobId`	integer · int32	Không	Đồ nhận công việc.
`price`	number · double	Không	Giá cả.
`brandId`	integer · int32	Không	Đơn vị thương hiệu.
`categoryClass`	stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS	Không	Nhóm hạng mục.
`categoryId`	integer · int32	Không	Phân loại ID.
`priority`	integer · int32	Không	Tự ưu tiên.
`productId`	integer · int64	Không	Đơn vị sản phẩm

curl --request POST 'https://api.selsup.ru/api/job/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/job/', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "categoryClass": "SHOES",
    "clientId": 1001,
    "deleted": false,
    "positionId": 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/job/', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "categoryClass": "SHOES",
    "clientId": 1001,
    "deleted": false,
    "positionId": 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/job/',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'id': 1001,
        'name': 'Example',
        'categoryClass': 'SHOES',
        'clientId': 1001,
        'deleted': False,
        'positionId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/job/',
    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/job/", strings.NewReader(`{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 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/job/"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 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 Job

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

id integer · int32 Không Id.

name string Không Tên.

categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Nhóm hạng mục.

clientId integer · int64 Không - Đồ nhận khách hàng.

deleted boolean Không - Quá xóa.

positionId integer · int64 Không Đơn vị ID.

versionId integer · int64 Không Phiên bản ID.

createdUser string Không Tạo User.

createdDate string · date-time Không Ngày được tạo ra.

price number · double Không Giá cả.

tariffs JobTariff[] Không Thuế thuế quan.

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

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int64	Không	Id.
`jobId`	integer · int32	Không	Đồ nhận công việc.
`price`	number · double	Không	Giá cả.
`brandId`	integer · int32	Không	Đơn vị thương hiệu.
`categoryClass`	stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS	Không	Nhóm hạng mục.
`categoryId`	integer · int32	Không	Phân loại ID.
`priority`	integer · int32	Không	Tự ưu tiên.
`productId`	integer · int64	Không	Đơn vị sản phẩm

{
  "id": 1001,
  "name": "Example",
  "categoryClass": "SHOES",
  "clientId": 1001,
  "deleted": false,
  "positionId": 1001
}

Hầm lẫn12

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_empty_category_class

Lớp không được chỉ định

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

400error_empty_job_price

Giá cho công việc không được chỉ định

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

400error_empty_position

Vị trí không được chỉ định

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

400error_empty_tariff_price

Giá không được chỉ định cho biểu giá{position}

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

400error_empty_tariff_priority

Không có ưu tiên nào được chỉ định cho biểu thuế số{position}

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

400error_empty_tariffs

Thuế quan không được chỉ định

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

400error_job_already_exists

Công việc có tên {jobName} đã tồn tại

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

400error_job_tariff_wrong_product_id

Số nhận dạng sản phẩm không chính xác: {id}

error cụ thể cho điểm cuối. Sử dụng mã error_job_tariff_wrong_product_id ổ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.

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

Bắt đầu sử dụng Job

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

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

Điểm cuối

Đặt công việc

Các tham số đường

Cơ quan yêu cầu

Phản ứng thành công

Tắt đi Job

Các tham số đường

Các tham số truy vấn

Phản ứng thành công

Công việc sau

Cơ quan yêu cầu

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