Жұмысқа

Қолдануға дайын жұмыс барысы

01

Жұмысты қолдануды бастаңыз

API токенін пайдаланып, оқу операцияларын бірінші кезекте тест деректерімен растаңыз.

Сервер жағында белгі сақтап, Authorization бағаншасына жіберіңіз.
Керек параметрлерді тексеріп, сұрау немесе жауап схемасын кеңейтіңіз.
HTTP күйін және error тұрақты өрісін қолданба қателерінде өңдеу.

PUTЖұмысты қой DELETEЖұбарын алып таста POSTЖұмыс орны

Деректер моделі

Деректер құрылымы

Модельдер бір рет осы жерде тізімделеді және оларды пайдаланатын соңғы нүктелерден тікелей кеңейтілуі мүмкін.

Job11 өрістер

idinteger · int32

Id.

namestring

Есім.

categoryClassstring

Категориялық сынып.

clientIdinteger · int64

Клиент танымдығы.

deletedboolean

Өшірілді.

positionIdinteger · int64

Орналасу ID.

versionIdinteger · int64

- Версия ID.

createdUserstring

Пайдаланушы құрылды.

createdDatestring · date-time

Жасау күні.

pricenumber · double

Баға.

tariffsJobTariff[]

Тарифтер.

JobTariff8 өрістер

idinteger · int64

Id.

jobIdinteger · int32

Жұмыс туралы куәлік.

pricenumber · double

Баға.

brandIdinteger · int32

Брендтің аты.

categoryClassstring

Категориялық сынып.

categoryIdinteger · int32

Категория ID.

priorityinteger · int32

Алдымен.

productIdinteger · int64

Өнімнің идентификаторы.

Қате туралы келісімшарт

Қолданба қателерін қайтару

error коды барлық жерлерде бірдей, ал пайдаланушымен бетпе-бет сөйлейтін хабарлама сервер арқылы аударылады. error-ге арналған қолданба логикасын құру және localMessage-ді көрсету үшін ғана пайдалану.

error

Интеграциялық логика үшін тұрақты машина оқуға болатын код.

localMessage

API белгі пайдаланушы тілінде көрсетілуге дайын хабарлама.

params

Сервердің жергілікті хабарлама үлгісіне интерполациялаған мәндері.

文

localMessage API белгісін иеленуші пайдаланушының lang өрісін пайдаланады. Құжаттама тілі мен Accept-Language баған оны өзгертпейді; орыс тілі пайдаланушының тілі конфигурацияланбаған кезде қолданылады.

RUПайдаланушы жері ru

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

KKҚазақша (kk)

{
  "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 Жоқ - Версия ID.

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	Жоқ	Категория ID.
`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 Жоқ - Версия ID.

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	Жоқ	Категория ID.
`priority`	integer · int32	Жоқ	Алдымен.
`productId`	integer · int64	Жоқ	Өнімнің идентификаторы.

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

Қателер14

Қолданба қателері JSON, error және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Жоқ - Версия ID.

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	Жоқ	Категория ID.
`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 Жоқ - Версия ID.

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	Жоқ	Категория ID.
`priority`	integer · int32	Жоқ	Алдымен.
`productId`	integer · int64	Жоқ	Өнімнің идентификаторы.

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

Қателер12

Қолданба қателері JSON, error және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 жоғарыда көрсетілген аударманы қамтиды.

Қолдануға дайын жұмыс барысы

Жұмысты қолдануды бастаңыз

Деректер құрылымы

Қолданба қателерін қайтару

Аяқ нүктелері

Жұмысты қой

Жол параметрлері

Өтініш органы

Жеңіспен жауап

Жұбарын алып таста

Жол параметрлері

Сұраныс параметрлері

Жеңіспен жауап

Жұмыс орны

Өтініш органы

Жеңіспен жауап

Сынақ өтiнiштерiне арналған белгі

Шын сұраныс параметрлері

Тікелей API жауап