İş

Kullanılabilir iş akışları

01

Job kullanmaya başla

Özel bir API token kullanın ve önce test verileri ile okuma işlemlerini doğrulayın.

Token sunucu tarafında tut ve Authorization başlığı gönder.
Gerekli parametreleri kontrol edin ve istek veya yanıt şeması genişletin.
Uygulama hatalarında HTTP durumunu ve sabit error alanını ele alın.

PUTİşini bırak DELETEİşten çıkar POSTİş sonrası

Verim modeli

Veriler yapısı

Modeller burada bir kez listelenmiştir ve bunları kullanan uç noktalardan doğrudan genişletilebilir.

Job11 alanlar

idinteger · int32

Id.

namestring

Adı.

categoryClassstring

Kategori sınıfı.

clientIdinteger · int64

Müşteri kimliği.

deletedboolean

- Sildi.

positionIdinteger · int64

Konum kimliği.

versionIdinteger · int64

Versiyon kimliği.

createdUserstring

Kullanıcı yaratıldı.

createdDatestring · date-time

Tarih yaratıldı.

pricenumber · double

- Fiyat.

tariffsJobTariff[]

Tarifler.

JobTariff8 alanlar

idinteger · int64

Id.

jobIdinteger · int32

İş kimliği.

pricenumber · double

- Fiyat.

brandIdinteger · int32

Marka kimliği.

categoryClassstring

Kategori sınıfı.

categoryIdinteger · int32

Kategori İd.

priorityinteger · int32

Öncelik.

productIdinteger · int64

Ürün Kimliği.

Hata sözleşmesi

Uygulama hataları nasıl iade edilir

error kodu her yerde aynıdır, kullanıcıya yönelik mesaj ise sunucu tarafından tercüme edilir. error etrafında uygulama mantığı oluşturun ve localMessage'i yalnızca görüntülemek için kullanın.

error

Entegre mantığı için sabit makine okunur kod.

localMessage

API token kullanıcısının dilinde görüntülemeye hazır mesaj.

params

Sunucu tarafından yerel mesaj şablonuna girilen değerler.

文

localMessage, API tokenine sahip olan kullanıcının lang alanını kullanır. Belgeleme dili ve Accept-Language başlığı değiştirmez; kullanıcıya dil yapılandırılmadığında Rusça kullanılır.

RUKullanıcı yerel ru

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

TRTürkçe (tr)

{
  "error": "error_brand_already_exists",
  "localMessage": "Base markası zaten mevcut",
  "params": {
    "name": "Base"
  }
}

Son noktaları

PUT

İşini bırak

/api/job/{jobId}

Yazma erişimli işaretleme

PUT /api/job/{jobId}. kullanarak Job koy

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`jobId`	integer · int64	Evet	İş kimliği.

İstekçi organ

application/json

Nesne alanlarıJob

Alan Tür Zorunlu Açıklama

id integer · int32 Hayır Id.

name string Hayır Adı.

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 Hayır Kategori sınıfı.

clientId integer · int64 Hayır Müşteri kimliği.

deleted boolean Hayır - Sildi.

positionId integer · int64 Hayır Konum kimliği.

versionId integer · int64 Hayır Versiyon kimliği.

createdUser string Hayır Kullanıcı yaratıldı.

createdDate string · date-time Hayır Tarih yaratıldı.

price number · double Hayır - Fiyat.

tariffs JobTariff[] Hayır Tarifler.

Array öğesi yapısı JobTariff

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`jobId`	integer · int32	Hayır	İş kimliği.
`price`	number · double	Hayır	- Fiyat.
`brandId`	integer · int32	Hayır	Marka kimliği.
`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	Hayır	Kategori sınıfı.
`categoryId`	integer · int32	Hayır	Kategori İd.
`priority`	integer · int32	Hayır	Öncelik.
`productId`	integer · int64	Hayır	Ürün Kimliği.

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

Başarılı tepki

200

Nesne alanları Job

Alan Tür Zorunlu Açıklama

id integer · int32 Hayır Id.

name string Hayır Adı.

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 Hayır Kategori sınıfı.

clientId integer · int64 Hayır Müşteri kimliği.

deleted boolean Hayır - Sildi.

positionId integer · int64 Hayır Konum kimliği.

versionId integer · int64 Hayır Versiyon kimliği.

createdUser string Hayır Kullanıcı yaratıldı.

createdDate string · date-time Hayır Tarih yaratıldı.

price number · double Hayır - Fiyat.

tariffs JobTariff[] Hayır Tarifler.

Array öğesi yapısı JobTariff

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`jobId`	integer · int32	Hayır	İş kimliği.
`price`	number · double	Hayır	- Fiyat.
`brandId`	integer · int32	Hayır	Marka kimliği.
`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	Hayır	Kategori sınıfı.
`categoryId`	integer · int32	Hayır	Kategori İd.
`priority`	integer · int32	Hayır	Öncelik.
`productId`	integer · int64	Hayır	Ürün Kimliği.

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

Hatalar14

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_empty_category_class

Sınıf belirtilmemiş

Uygulama mantığında sabit error_empty_category_class kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_job_price

İş yapımı için fiyat belirtilmemiş

Uygulama mantığında sabit error_empty_job_price kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_position

Pozisyon belirtilmemiş

Uygulama mantığında sabit error_empty_position kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_tariff_price

{position} numaralı tarife için fiyat belirtilmemiş

Uygulama mantığında sabit error_empty_tariff_price kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_tariff_priority

Tarife için öncelik belirtilmemiş

Uygulama mantığında sabit error_empty_tariff_priority kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_tariffs

Tarifeler belirtilmemiş

Uygulama mantığında sabit error_empty_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_job_already_exists

{jobName} adında bir görev zaten mevcut

Uygulama mantığında sabit error_job_already_exists kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_job_modified

İş verileri zaten güncellendi. Sayfayı yenileyin.

Uygulama mantığında sabit error_job_modified kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_job_tariff_wrong_product_id

Ürün kimliği hatalı belirtilmiş: {id}

Uygulama mantığında sabit error_job_tariff_wrong_product_id kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client

Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

Uygulama mantığında sabit error_subscription_expired kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

DELETE

İşten çıkar

/api/job/{jobId}

Yazma erişimli işaretleme

DELETE /api/job/{jobId}. kullanarak İş Yerini Kaldır

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`jobId`	integer · int32	Evet	İş kimliği.

Sorgulama parametreleri

Alan	Tür	Zorunlu	Açıklama
`deleted`	boolean	Evet	- Sildi.

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

Başarılı tepki

200

"string"

Hatalar6

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_job_modified

İş verileri zaten güncellendi. Sayfayı yenileyin.

Uygulama mantığında sabit error_job_modified kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client

Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_subscription_expired

Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

Uygulama mantığında sabit error_subscription_expired kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

POST

İş sonrası

/api/job/

Yazma erişimli işaretleme

POST /api/job/. kullanarak iş gönder

İstekçi organ

application/json

Nesne alanlarıJob

Alan Tür Zorunlu Açıklama

id integer · int32 Hayır Id.

name string Hayır Adı.

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 Hayır Kategori sınıfı.

clientId integer · int64 Hayır Müşteri kimliği.

deleted boolean Hayır - Sildi.

positionId integer · int64 Hayır Konum kimliği.

versionId integer · int64 Hayır Versiyon kimliği.

createdUser string Hayır Kullanıcı yaratıldı.

createdDate string · date-time Hayır Tarih yaratıldı.

price number · double Hayır - Fiyat.

tariffs JobTariff[] Hayır Tarifler.

Array öğesi yapısı JobTariff

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`jobId`	integer · int32	Hayır	İş kimliği.
`price`	number · double	Hayır	- Fiyat.
`brandId`	integer · int32	Hayır	Marka kimliği.
`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	Hayır	Kategori sınıfı.
`categoryId`	integer · int32	Hayır	Kategori İd.
`priority`	integer · int32	Hayır	Öncelik.
`productId`	integer · int64	Hayır	Ürün Kimliği.

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

Başarılı tepki

200

Nesne alanları Job

Alan Tür Zorunlu Açıklama

id integer · int32 Hayır Id.

name string Hayır Adı.

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 Hayır Kategori sınıfı.

clientId integer · int64 Hayır Müşteri kimliği.

deleted boolean Hayır - Sildi.

positionId integer · int64 Hayır Konum kimliği.

versionId integer · int64 Hayır Versiyon kimliği.

createdUser string Hayır Kullanıcı yaratıldı.

createdDate string · date-time Hayır Tarih yaratıldı.

price number · double Hayır - Fiyat.

tariffs JobTariff[] Hayır Tarifler.

Array öğesi yapısı JobTariff

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`jobId`	integer · int32	Hayır	İş kimliği.
`price`	number · double	Hayır	- Fiyat.
`brandId`	integer · int32	Hayır	Marka kimliği.
`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	Hayır	Kategori sınıfı.
`categoryId`	integer · int32	Hayır	Kategori İd.
`priority`	integer · int32	Hayır	Öncelik.
`productId`	integer · int64	Hayır	Ürün Kimliği.

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

Hatalar12

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_empty_category_class

Sınıf belirtilmemiş

Uygulama mantığında sabit error_empty_category_class kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_job_price

İş yapımı için fiyat belirtilmemiş

Uygulama mantığında sabit error_empty_job_price kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_position

Pozisyon belirtilmemiş

Uygulama mantığında sabit error_empty_position kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_tariff_price

{position} numaralı tarife için fiyat belirtilmemiş

Uygulama mantığında sabit error_empty_tariff_price kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_tariff_priority

Tarife için öncelik belirtilmemiş

Uygulama mantığında sabit error_empty_tariff_priority kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_tariffs

Tarifeler belirtilmemiş

Uygulama mantığında sabit error_empty_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_job_already_exists

{jobName} adında bir görev zaten mevcut

Uygulama mantığında sabit error_job_already_exists kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_job_tariff_wrong_product_id

Ürün kimliği hatalı belirtilmiş: {id}

Uygulama mantığında sabit error_job_tariff_wrong_product_id kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client

Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

Kullanılabilir iş akışları

Job kullanmaya başla

Veriler yapısı

Uygulama hataları nasıl iade edilir

Son noktaları

İşini bırak

Yol parametreleri

İstekçi organ

Başarılı tepki

İşten çıkar

Yol parametreleri

Sorgulama parametreleri

Başarılı tepki

İş sonrası

İstekçi organ

Başarılı tepki

Test istekleri için işaret

Gerçek talep parametreleri

Canlı API tepkisi