Praca

Gotowe do użytkowania przepływy robocze

01

Zacznij używać Job

Użyj dedykowanego tokena API i najpierw sprawdź operacje odczytu z danymi testowymi.

Trzymaj token z serwera i wysłać go w nagłówku Authorization.
Sprawdź wymagane parametry i poszerz schemat żądania lub odpowiedzi.
Zrób z statusem HTTP i stabilnym pole error w przypadku błędów aplikacyjnych.

PUTZłóż pracę DELETEZdejmij Job POSTPost Job

Model danych

Struktura danych

Modele są wymienione tutaj raz i mogą być również rozszerzane bezpośrednio z punktów końcowych, które je wykorzystują.

Job11 pola

idinteger · int32

Id.

namestring

- Nazwa.

categoryClassstring

Klasy kategorii.

clientIdinteger · int64

Id klientów.

deletedboolean

- Zlikwidowane.

positionIdinteger · int64

Id pozycji.

versionIdinteger · int64

Id wersji.

createdUserstring

Tworzony Użytkownik.

createdDatestring · date-time

Tworzony Termin.

pricenumber · double

- Cena.

tariffsJobTariff[]

- Ceny.

JobTariff8 pola

idinteger · int64

Id.

jobIdinteger · int32

Identyfikacja pracy.

pricenumber · double

- Cena.

brandIdinteger · int32

- Idem marka.

categoryClassstring

Klasy kategorii.

categoryIdinteger · int32

Kategoria ID.

priorityinteger · int32

Priorytet.

productIdinteger · int64

Id produktu.

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

文

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru

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

PLPolski (pl)

{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

PUT

Złóż pracę

/api/job/{jobId}

Token z dostępem do pisania

Wstawić Job za pomocą PUT /api/job/{jobId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`jobId`	integer · int64	Tak	Identyfikacja pracy.

Organ wnioskujący

application/json

Połączenia obiektuJob

Pole Typ Wymagane Opis

id integer · int32 Nie Id.

name string Nie - Nazwa.

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 Nie Klasy kategorii.

clientId integer · int64 Nie Id klientów.

deleted boolean Nie - Zlikwidowane.

positionId integer · int64 Nie Id pozycji.

versionId integer · int64 Nie Id wersji.

createdUser string Nie Tworzony Użytkownik.

createdDate string · date-time Nie Tworzony Termin.

price number · double Nie - Cena.

tariffs JobTariff[] Nie - Ceny.

Struktura pozycji zestawu JobTariff

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`jobId`	integer · int32	Nie	Identyfikacja pracy.
`price`	number · double	Nie	- Cena.
`brandId`	integer · int32	Nie	- Idem marka.
`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	Nie	Klasy kategorii.
`categoryId`	integer · int32	Nie	Kategoria ID.
`priority`	integer · int32	Nie	Priorytet.
`productId`	integer · int64	Nie	Id produktu.

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

Odpowiedź udana

200

Połączenia obiektu Job

Pole Typ Wymagane Opis

id integer · int32 Nie Id.

name string Nie - Nazwa.

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 Nie Klasy kategorii.

clientId integer · int64 Nie Id klientów.

deleted boolean Nie - Zlikwidowane.

positionId integer · int64 Nie Id pozycji.

versionId integer · int64 Nie Id wersji.

createdUser string Nie Tworzony Użytkownik.

createdDate string · date-time Nie Tworzony Termin.

price number · double Nie - Cena.

tariffs JobTariff[] Nie - Ceny.

Struktura pozycji zestawu JobTariff

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`jobId`	integer · int32	Nie	Identyfikacja pracy.
`price`	number · double	Nie	- Cena.
`brandId`	integer · int32	Nie	- Idem marka.
`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	Nie	Klasy kategorii.
`categoryId`	integer · int32	Nie	Kategoria ID.
`priority`	integer · int32	Nie	Priorytet.
`productId`	integer · int64	Nie	Id produktu.

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

Władze14

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_empty_category_class

Nie określono klasy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_category_class; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_job_price

Nie określono ceny za wykonanie pracy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_job_price; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_position

Nie podano stanowiska

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_position; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_tariff_price

Nie podano ceny dla taryfy nr {position}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_tariff_price; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_tariff_priority

Nie określono priorytetu dla taryfy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_tariff_priority; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_tariffs

Nie określono taryf

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_tariffs; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_job_already_exists

Zadanie o nazwie {jobName} już istnieje

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_job_already_exists; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_job_modified

Dane o pracy zostały już zaktualizowane. Odśwież stronę.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_job_modified; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_job_tariff_wrong_product_id

Niepoprawnie podano identyfikator produktu: {id}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_job_tariff_wrong_product_id; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

DELETE

Zdejmij Job

/api/job/{jobId}

Token z dostępem do pisania

Usunięcie pracy za pomocą DELETE /api/job/{jobId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`jobId`	integer · int32	Tak	Identyfikacja pracy.

Parametry zapytania

Pole	Typ	Wymagane	Opis
`deleted`	boolean	Tak	- Zlikwidowane.

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

Odpowiedź udana

200

"string"

Władze6

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_job_modified

Dane o pracy zostały już zaktualizowane. Odśwież stronę.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_job_modified; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired

Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

POST

Post Job

/api/job/

Token z dostępem do pisania

Wyślij pracę za pomocą POST /api/job/.

Organ wnioskujący

application/json

Połączenia obiektuJob

Pole Typ Wymagane Opis

id integer · int32 Nie Id.

name string Nie - Nazwa.

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 Nie Klasy kategorii.

clientId integer · int64 Nie Id klientów.

deleted boolean Nie - Zlikwidowane.

positionId integer · int64 Nie Id pozycji.

versionId integer · int64 Nie Id wersji.

createdUser string Nie Tworzony Użytkownik.

createdDate string · date-time Nie Tworzony Termin.

price number · double Nie - Cena.

tariffs JobTariff[] Nie - Ceny.

Struktura pozycji zestawu JobTariff

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`jobId`	integer · int32	Nie	Identyfikacja pracy.
`price`	number · double	Nie	- Cena.
`brandId`	integer · int32	Nie	- Idem marka.
`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	Nie	Klasy kategorii.
`categoryId`	integer · int32	Nie	Kategoria ID.
`priority`	integer · int32	Nie	Priorytet.
`productId`	integer · int64	Nie	Id produktu.

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

Odpowiedź udana

200

Połączenia obiektu Job

Pole Typ Wymagane Opis

id integer · int32 Nie Id.

name string Nie - Nazwa.

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 Nie Klasy kategorii.

clientId integer · int64 Nie Id klientów.

deleted boolean Nie - Zlikwidowane.

positionId integer · int64 Nie Id pozycji.

versionId integer · int64 Nie Id wersji.

createdUser string Nie Tworzony Użytkownik.

createdDate string · date-time Nie Tworzony Termin.

price number · double Nie - Cena.

tariffs JobTariff[] Nie - Ceny.

Struktura pozycji zestawu JobTariff

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`jobId`	integer · int32	Nie	Identyfikacja pracy.
`price`	number · double	Nie	- Cena.
`brandId`	integer · int32	Nie	- Idem marka.
`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	Nie	Klasy kategorii.
`categoryId`	integer · int32	Nie	Kategoria ID.
`priority`	integer · int32	Nie	Priorytet.
`productId`	integer · int64	Nie	Id produktu.

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

Władze12

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_empty_category_class

Nie określono klasy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_category_class; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_job_price

Nie określono ceny za wykonanie pracy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_job_price; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_position

Nie podano stanowiska

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_position; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_tariff_price

Nie podano ceny dla taryfy nr {position}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_tariff_price; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_tariff_priority

Nie określono priorytetu dla taryfy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_tariff_priority; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_tariffs

Nie określono taryf

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_tariffs; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_job_already_exists

Zadanie o nazwie {jobName} już istnieje

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_job_already_exists; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_job_tariff_wrong_product_id

Niepoprawnie podano identyfikator produktu: {id}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_job_tariff_wrong_product_id; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

Gotowe do użytkowania przepływy robocze

Zacznij używać Job

Struktura danych

W jaki sposób można zwrócić błędy w aplikacji

Punkty końcowe

Złóż pracę

Parametry ścieżki

Organ wnioskujący

Odpowiedź udana

Zdejmij Job

Parametry ścieżki

Parametry zapytania

Odpowiedź udana

Post Job

Organ wnioskujący

Odpowiedź udana

Token do wniosków o badania

Prawdziwe parametry żądania

Odpowiedź API