Жумуш

Колдонууга даяр жумуш жүрүштөрү

01

Жубаны колдонууну баштаңыз

API белгисин колдонуп, биринчиден тесттик маалыматтар менен окуу операцияларын тастыктаңыз.

Токенди сервер тарапка сактап, Authorization башкыга жөнөт.
Керектүү параметрлерди текшерип, суроо же жооп схемасын кеңейтүү.
HTTP абалы жана error туруктуу талаасы колдонмо каталарында иштелип чыгышы керек.

PUTЖумушту ташта DELETEЖубайымды алып сал POSTЖумушпоздук

Маалыматтын модели

Маалыматтар структурасы

Бул жерде моделдер бир жолу көрсөтүлгөн жана аларды колдонгон акыркы пункттардан түздөн-түз кеңейтилген.

Job11 аймактар

idinteger · int32

Id.

namestring

Аты.

categoryClassstring

Категориялык класстар.

clientIdinteger · int64

Кардар ID.

deletedboolean

Жок кылынды.

positionIdinteger · int64

Ордунун идентификатору.

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

Продукт ID.

Келишимдин катасы

Колдонмо каталарын кантип кайтаруу керек

error коду ар бир жергиликтүү жерде бирдей, ал эми колдонуучуга багытталган билдирүүнү сервер которат. error айланасында тиркеме логикасын түзүп, localMessageди көрсөтүү үчүн гана колдонуңуз.

error

Интеграция логикасы үчүн туруктуу машина окуй турган код.

localMessage

API белги колдонуучусунун тилинде көрсөтүүгө даяр билдирүү.

params

Сервер тарабынан локалдаштырылган билдирүү шаблондоруна интерполяцияланган баалуулуктар.

文

localMessage API белгиси ээси болгон колдонуучунун lang талаасын колдонот. Документация тили жана Accept-Language башчысы аны өзгөртпөйт; колдонуучу тилди конфигурациялабаган учурда орусча колдонулат.

RUКолдонуучунун жергиликтүү жергилиги ru

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

KYКыргызча (ky)

{
  "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 Жок Кардар ID.

deleted boolean Жок Жок кылынды.

positionId integer · int64 Жок Ордунун идентификатору.

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.

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 Жок Кардар ID.

deleted boolean Жок Жок кылынды.

positionId integer · int64 Жок Ордунун идентификатору.

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.

{
  "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

Класс көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_category_class кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_job_price

Жумушту аткаруу үчүн баа көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_job_price кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_position

Кызмат орду көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_position кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_tariff_price

№{position} тариф үчүн баа көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_tariff_price кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_tariff_priority

Тариф үчүн приоритет көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_tariff_priority кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_tariffs

Тарифтер көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_tariffs кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_job_already_exists

{jobName} аталышындагы тапшырма мурунтан эле бар

Endpoint-specific error. Колдонмо логикасында туруктуу error_job_already_exists кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_job_modified

Иш жөнүндө маалыматтар жаңыртылды. Баракчаны жаңыртыңыз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_job_modified кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_job_tariff_wrong_product_id

Товардын идентификатору туура эмес көрсөтүлгөн: {id}

Endpoint-specific error. Колдонмо логикасында туруктуу error_job_tariff_wrong_product_id кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_client

Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired

Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific 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

Иш жөнүндө маалыматтар жаңыртылды. Баракчаны жаңыртыңыз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_job_modified кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_client

Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired

Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific 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 Жок Кардар ID.

deleted boolean Жок Жок кылынды.

positionId integer · int64 Жок Ордунун идентификатору.

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.

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 Жок Кардар ID.

deleted boolean Жок Жок кылынды.

positionId integer · int64 Жок Ордунун идентификатору.

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.

{
  "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

Класс көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_category_class кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_job_price

Жумушту аткаруу үчүн баа көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_job_price кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_position

Кызмат орду көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_position кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_tariff_price

№{position} тариф үчүн баа көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_tariff_price кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_tariff_priority

Тариф үчүн приоритет көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_tariff_priority кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_empty_tariffs

Тарифтер көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_empty_tariffs кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_job_already_exists

{jobName} аталышындагы тапшырма мурунтан эле бар

Endpoint-specific error. Колдонмо логикасында туруктуу error_job_already_exists кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_job_tariff_wrong_product_id

Товардын идентификатору туура эмес көрсөтүлгөн: {id}

Endpoint-specific error. Колдонмо логикасында туруктуу error_job_tariff_wrong_product_id кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_client

Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

Колдонууга даяр жумуш жүрүштөрү

Жубаны колдонууну баштаңыз

Маалыматтар структурасы

Колдонмо каталарын кантип кайтаруу керек

Акыркы пункттар

Жумушту ташта

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

Талап боюнча орган

Ийгиликтүү жооп

Жубайымды алып сал

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

Сурамжылоо параметрлери

Ийгиликтүү жооп

Жумушпоздук

Талап боюнча орган

Ийгиликтүү жооп

Сынак өтүнүчтөрү үчүн белги

Чыныгы өтүнүч параметрлери

API түздөн-түз жооп