Праца

Готовыя да выкарыстання працоўныя патокі

01

Пачніце выкарыстоўваць Job

Выкарыстоўвайце адмысловы токен API і пацвердзіце аперацыі чытання з дадзенымі тэсту спачатку.

Захоўвайце знак з боку сервера і адправіце яго ў заголоўку Authorization.
Праверце патрабаваныя параметры і пашырыць схему запыту або адказу.
Выкарыстоўвайце стан HTTP і стабільнае поле error ў памылках прыкладання.

PUTПастаўце працу DELETEЗнімайце Джоб POSTПасля працы

Мадэль дадзеных

Структуры дадзеных

Мадэлі пералічаныя тут адзін раз і могуць быць пашыраныя непасрэдна з канчатковых пунктаў, якія іх выкарыстоўваюць.

Job11 палёў

idinteger · int32

Id.

namestring

Назва.

categoryClassstring

Клас катэгорыі.

clientIdinteger · int64

Ідэнтыфікатар кліента.

deletedboolean

Здарэнне.

positionIdinteger · int64

Пазіцыя ID.

versionIdinteger · int64

Ід версіі.

createdUserstring

Створаны карыстальнік.

createdDatestring · date-time

Стварыўся Дата.

pricenumber · double

Прэс.

tariffsJobTariff[]

Падаткі.

JobTariff8 палёў

idinteger · int64

Id.

jobIdinteger · int32

Ід працоўнай асобы.

pricenumber · double

Прэс.

brandIdinteger · int32

Ід брэнда.

categoryClassstring

Клас катэгорыі.

categoryIdinteger · int32

Ід катэгорыі.

priorityinteger · int32

Пераважнасць.

productIdinteger · int64

Ід прадукту.

Памылка дагавор

Як вяртаюць памылкі прыкладання

Код error аднолькавы ў кожным лакелі, у той час як паведамленне, якое з'яўляецца карыстальнікам, перакладаецца серверам.

error

Стабільны машыначытай код для інтэграцыйнай логікі.

localMessage

Паведамленне гатовае да адлюстравання на мове карыстальніка токены API.

params

Значэнні, якія інтэрполююцца серверам у лакалізаваным шаблоне паведамленняў.

文

localMessage выкарыстоўвае поле lang карыстальніка, які валодае токеном API. Мова дакументацыі і загаловак Accept-Language не змяняюць яго; руская выкарыстоўваецца, калі карыстацкая мова не канфігуруецца.

RUМясцовасць карыстальніка ru

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

BEБеларуская (be)

{
  "error": "error_brand_already_exists",
  "localMessage": "Брэнд Base ужо існуе",
  "params": {
    "name": "Base"
  }
}

Канчатковыя пункты

PUT

Пастаўце працу

/api/job/{jobId}

Знак з пісьмовым доступам

Падключыць працу з дапамогай PUT /api/job/{jobId}.

Параметры шляху

Поле	Тып	Абавязкова	Апісанне
`jobId`	integer · int64	Так	Ід працоўнай асобы.

Запытвальны орган

application/json

Палі аб'ектаўJob

Поле Тып Абавязкова Апісанне

id integer · int32 Не Id.

name string Не Назва.

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 Не Клас катэгорыі.

clientId integer · int64 Не Ідэнтыфікатар кліента.

deleted boolean Не Здарэнне.

positionId integer · int64 Не Пазіцыя ID.

versionId integer · int64 Не Ід версіі.

createdUser string Не Створаны карыстальнік.

createdDate string · date-time Не Стварыўся Дата.

price number · double Не Прэс.

tariffs JobTariff[] Не Падаткі.

Структура элементаў масіва JobTariff

Поле	Тып	Абавязкова	Апісанне
`id`	integer · int64	Не	Id.
`jobId`	integer · int32	Не	Ід працоўнай асобы.
`price`	number · double	Не	Прэс.
`brandId`	integer · int32	Не	Ід брэнда.
`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	Не	Клас катэгорыі.
`categoryId`	integer · int32	Не	Ід катэгорыі.
`priority`	integer · int32	Не	Пераважнасць.
`productId`	integer · int64	Не	Ід прадукту.

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

Удалы адказ

200

Палі аб'ектаў Job

Поле Тып Абавязкова Апісанне

id integer · int32 Не Id.

name string Не Назва.

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 Не Клас катэгорыі.

clientId integer · int64 Не Ідэнтыфікатар кліента.

deleted boolean Не Здарэнне.

positionId integer · int64 Не Пазіцыя ID.

versionId integer · int64 Не Ід версіі.

createdUser string Не Створаны карыстальнік.

createdDate string · date-time Не Стварыўся Дата.

price number · double Не Прэс.

tariffs JobTariff[] Не Падаткі.

Структура элементаў масіва JobTariff

Поле	Тып	Абавязкова	Апісанне
`id`	integer · int64	Не	Id.
`jobId`	integer · int32	Не	Ід працоўнай асобы.
`price`	number · double	Не	Прэс.
`brandId`	integer · int32	Не	Ід брэнда.
`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	Не	Клас катэгорыі.
`categoryId`	integer · int32	Не	Ід катэгорыі.
`priority`	integer · int32	Не	Пераважнасць.
`productId`	integer · int64	Не	Ід прадукту.

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

Памылкі14

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_empty_category_class

Не пазначаны клас

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_category_class ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_job_price

Не пазначана цана для выканання работы

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_job_price ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_position

Не пазначана пасада

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_position ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariff_price

Не пазначана цана для тарыфа №{position}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariff_price ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariff_priority

Не пазначаны прыярытэт для тарыфа

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariff_priority ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariffs

Не пазначаны тарыфы

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariffs ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_job_already_exists

Заданне з назвай {jobName} ужо існуе

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_job_already_exists ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_job_modified

Дадзеныя аб працы ўжо абноўлены. Абнавіце старонку.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_job_modified ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_job_tariff_wrong_product_id

Некарэктна пазначаны ідэнтыфікатар тавару: {id}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_job_tariff_wrong_product_id ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client

Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_subscription_expired

У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_subscription_expired ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

DELETE

Знімайце Джоб

/api/job/{jobId}

Знак з пісьмовым доступам

Зніміце працу з дапамогай DELETE /api/job/{jobId}.

Параметры шляху

Поле	Тып	Абавязкова	Апісанне
`jobId`	integer · int32	Так	Ід працоўнай асобы.

Параметры запытаў

Поле	Тып	Абавязкова	Апісанне
`deleted`	boolean	Так	Здарэнне.

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

Удалы адказ

200

"string"

Памылкі6

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_job_modified

Дадзеныя аб працы ўжо абноўлены. Абнавіце старонку.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_job_modified ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client

Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_subscription_expired

У вас скончыўся тэрмін дзеяння тарыфа. Аплаціце тарыф для працягу выкарыстання сэрвісу.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_subscription_expired ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

POST

Пасля працы

/api/job/

Знак з пісьмовым доступам

Запіс працы з дапамогай POST /api/job/.

Запытвальны орган

application/json

Палі аб'ектаўJob

Поле Тып Абавязкова Апісанне

id integer · int32 Не Id.

name string Не Назва.

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 Не Клас катэгорыі.

clientId integer · int64 Не Ідэнтыфікатар кліента.

deleted boolean Не Здарэнне.

positionId integer · int64 Не Пазіцыя ID.

versionId integer · int64 Не Ід версіі.

createdUser string Не Створаны карыстальнік.

createdDate string · date-time Не Стварыўся Дата.

price number · double Не Прэс.

tariffs JobTariff[] Не Падаткі.

Структура элементаў масіва JobTariff

Поле	Тып	Абавязкова	Апісанне
`id`	integer · int64	Не	Id.
`jobId`	integer · int32	Не	Ід працоўнай асобы.
`price`	number · double	Не	Прэс.
`brandId`	integer · int32	Не	Ід брэнда.
`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	Не	Клас катэгорыі.
`categoryId`	integer · int32	Не	Ід катэгорыі.
`priority`	integer · int32	Не	Пераважнасць.
`productId`	integer · int64	Не	Ід прадукту.

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

Удалы адказ

200

Палі аб'ектаў Job

Поле Тып Абавязкова Апісанне

id integer · int32 Не Id.

name string Не Назва.

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 Не Клас катэгорыі.

clientId integer · int64 Не Ідэнтыфікатар кліента.

deleted boolean Не Здарэнне.

positionId integer · int64 Не Пазіцыя ID.

versionId integer · int64 Не Ід версіі.

createdUser string Не Створаны карыстальнік.

createdDate string · date-time Не Стварыўся Дата.

price number · double Не Прэс.

tariffs JobTariff[] Не Падаткі.

Структура элементаў масіва JobTariff

Поле	Тып	Абавязкова	Апісанне
`id`	integer · int64	Не	Id.
`jobId`	integer · int32	Не	Ід працоўнай асобы.
`price`	number · double	Не	Прэс.
`brandId`	integer · int32	Не	Ід брэнда.
`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	Не	Клас катэгорыі.
`categoryId`	integer · int32	Не	Ід катэгорыі.
`priority`	integer · int32	Не	Пераважнасць.
`productId`	integer · int64	Не	Ід прадукту.

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

Памылкі12

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required

Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied

Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown

Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_empty_category_class

Не пазначаны клас

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_category_class ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_job_price

Не пазначана цана для выканання работы

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_job_price ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_position

Не пазначана пасада

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_position ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariff_price

Не пазначана цана для тарыфа №{position}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariff_price ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariff_priority

Не пазначаны прыярытэт для тарыфа

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariff_priority ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_tariffs

Не пазначаны тарыфы

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_tariffs ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_job_already_exists

Заданне з назвай {jobName} ужо існуе

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_job_already_exists ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_job_tariff_wrong_product_id

Некарэктна пазначаны ідэнтыфікатар тавару: {id}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_job_tariff_wrong_product_id ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client

Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

Готовыя да выкарыстання працоўныя патокі

Пачніце выкарыстоўваць Job

Структуры дадзеных

Як вяртаюць памылкі прыкладання

Канчатковыя пункты

Пастаўце працу

Параметры шляху

Запытвальны орган

Удалы адказ

Знімайце Джоб

Параметры шляху

Параметры запытаў

Удалы адказ

Пасля працы

Запытвальны орган

Удалы адказ

Знак для запытаў на выпрабаванне

Рэальныя параметры запыту

Жывы адказ API