El trabajo

Flujos de trabajo listos para su uso

01

Comience a usar Job

Utilice un token API dedicado y valida primero las operaciones de lectura con los datos de prueba.

Mantenga el token en el lado del servidor y envíelo en el encabezado Authorization.
Verifique los parámetros requeridos y amplíe el esquema de solicitud o respuesta.
Manejar el estado HTTP y el campo estable error en errores de aplicación.

PUTPonga trabajo DELETEQuita a Job POSTTrabajo posterior

Modelo de datos

Estructuras de datos

Los modelos se enumeran una vez aquí y también se pueden ampliar directamente desde los puntos finales que los utilizan.

Job11 campos

idinteger · int32

Id.

namestring

- ¿Cómo se llama?

categoryClassstring

Clasificación de categoría.

clientIdinteger · int64

Identificación del cliente.

deletedboolean

Se borró.

positionIdinteger · int64

Identificación de posición.

versionIdinteger · int64

La versión ID.

createdUserstring

Creado por el usuario.

createdDatestring · date-time

Creado fecha.

pricenumber · double

El precio.

tariffsJobTariff[]

Los aranceles.

JobTariff8 campos

idinteger · int64

Id.

jobIdinteger · int32

Identificación de trabajo.

pricenumber · double

El precio.

brandIdinteger · int32

Identificación de marca.

categoryClassstring

Clasificación de categoría.

categoryIdinteger · int32

Identificación de categoría.

priorityinteger · int32

Prioridad.

productIdinteger · int64

Identificación del producto.

Contrato de error

Cómo se devuelven los errores de aplicación

El código error es idéntico en todas las localizaciones, mientras que el mensaje orientado al usuario es traducido por el servidor.

Exproteccion

Código estable legible por máquina para la lógica de integración.

Exproteccion

Mensaje listo para la pantalla en el idioma del usuario de tokens API.

Exproteccion

Valores interpolados por el servidor en la plantilla de mensaje localizado.

文

localMessage utiliza el campo lang del usuario que posee el token API. El lenguaje de documentación y el encabezado Accept-Language no lo cambian; el ruso se utiliza cuando el usuario no tiene un idioma configurado.

RUEl lugar del usuario es ru

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

ESEspañol (es)

{
  "error": "error_brand_already_exists",
  "localMessage": "La marca Base ya existe",
  "params": {
    "name": "Base"
  }
}

Puntos finales

PUT

Ponga trabajo

/api/job/{jobId}

Token con acceso a escribir

Colocar trabajo usando PUT /api/job/{jobId}.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`jobId`	integer · int64	Sí	Identificación de trabajo.

Organismo de solicitud

application/json

Campos de objetosJob

Campo Tipo Obligatorio Descripción

id integer · int32 No Id.

name string No - ¿Cómo se llama?

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 No Clasificación de categoría.

clientId integer · int64 No Identificación del cliente.

deleted boolean No Se borró.

positionId integer · int64 No Identificación de posición.

versionId integer · int64 No La versión ID.

createdUser string No Creado por el usuario.

createdDate string · date-time No Creado fecha.

price number · double No El precio.

tariffs JobTariff[] No Los aranceles.

Estructura de los elementos del array JobTariff

Campo	Tipo	Obligatorio	Descripción
`id`	integer · int64	No	Id.
`jobId`	integer · int32	No	Identificación de trabajo.
`price`	number · double	No	El precio.
`brandId`	integer · int32	No	Identificación de marca.
`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	No	Clasificación de categoría.
`categoryId`	integer · int32	No	Identificación de categoría.
`priority`	integer · int32	No	Prioridad.
`productId`	integer · int64	No	Identificación del producto.

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

Respuesta exitosa

200

Campos de objetos Job

Campo Tipo Obligatorio Descripción

id integer · int32 No Id.

name string No - ¿Cómo se llama?

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 No Clasificación de categoría.

clientId integer · int64 No Identificación del cliente.

deleted boolean No Se borró.

positionId integer · int64 No Identificación de posición.

versionId integer · int64 No La versión ID.

createdUser string No Creado por el usuario.

createdDate string · date-time No Creado fecha.

price number · double No El precio.

tariffs JobTariff[] No Los aranceles.

Estructura de los elementos del array JobTariff

Campo	Tipo	Obligatorio	Descripción
`id`	integer · int64	No	Id.
`jobId`	integer · int32	No	Identificación de trabajo.
`price`	number · double	No	El precio.
`brandId`	integer · int32	No	Identificación de marca.
`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	No	Clasificación de categoría.
`categoryId`	integer · int32	No	Identificación de categoría.
`priority`	integer · int32	No	Prioridad.
`productId`	integer · int64	No	Identificación del producto.

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

Errores14

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_empty_category_class

No se ha especificado la clase

error específico de punto final. Utilice el código estable error_empty_category_class en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_job_price

No se especificó el precio para realizar el trabajo

error específico de punto final. Utilice el código estable error_empty_job_price en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_position

Cargo no especificado

error específico de punto final. Utilice el código estable error_empty_position en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_tariff_price

No se ha especificado el precio para la tarifa nº{position}

error específico de punto final. Utilice el código estable error_empty_tariff_price en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_tariff_priority

No se especificó la prioridad para la tarifa

error específico de punto final. Utilice el código estable error_empty_tariff_priority en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_tariffs

No se han especificado tarifas

error específico de punto final. Utilice el código estable error_empty_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_job_already_exists

La tarea con el nombre {jobName} ya existe

error específico de punto final. Utilice el código estable error_job_already_exists en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_job_modified

Los datos del trabajo ya han sido actualizados. Actualice la página.

error específico de punto final. Utilice el código estable error_job_modified en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_job_tariff_wrong_product_id

Identificador de producto especificado incorrectamente: {id}

error específico de punto final. Utilice el código estable error_job_tariff_wrong_product_id en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client

Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

error específico de punto final. Utilice el código estable error_subscription_expired en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

DELETE

Quita a Job

/api/job/{jobId}

Token con acceso a escribir

Eliminar el trabajo con DELETE /api/job/{jobId}.

Parámetros de trayectoria

Campo	Tipo	Obligatorio	Descripción
`jobId`	integer · int32	Sí	Identificación de trabajo.

Parámetros de consulta

Campo	Tipo	Obligatorio	Descripción
`deleted`	boolean	Sí	Se borró.

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

Respuesta exitosa

200

"string"

Errores6

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_job_modified

Los datos del trabajo ya han sido actualizados. Actualice la página.

error específico de punto final. Utilice el código estable error_job_modified en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client

Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_subscription_expired

Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

error específico de punto final. Utilice el código estable error_subscription_expired en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

POST

Trabajo posterior

/api/job/

Token con acceso a escribir

Publicación de trabajo con POST /api/job/.

Organismo de solicitud

application/json

Campos de objetosJob

Campo Tipo Obligatorio Descripción

id integer · int32 No Id.

name string No - ¿Cómo se llama?

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 No Clasificación de categoría.

clientId integer · int64 No Identificación del cliente.

deleted boolean No Se borró.

positionId integer · int64 No Identificación de posición.

versionId integer · int64 No La versión ID.

createdUser string No Creado por el usuario.

createdDate string · date-time No Creado fecha.

price number · double No El precio.

tariffs JobTariff[] No Los aranceles.

Estructura de los elementos del array JobTariff

Campo	Tipo	Obligatorio	Descripción
`id`	integer · int64	No	Id.
`jobId`	integer · int32	No	Identificación de trabajo.
`price`	number · double	No	El precio.
`brandId`	integer · int32	No	Identificación de marca.
`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	No	Clasificación de categoría.
`categoryId`	integer · int32	No	Identificación de categoría.
`priority`	integer · int32	No	Prioridad.
`productId`	integer · int64	No	Identificación del producto.

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

Respuesta exitosa

200

Campos de objetos Job

Campo Tipo Obligatorio Descripción

id integer · int32 No Id.

name string No - ¿Cómo se llama?

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 No Clasificación de categoría.

clientId integer · int64 No Identificación del cliente.

deleted boolean No Se borró.

positionId integer · int64 No Identificación de posición.

versionId integer · int64 No La versión ID.

createdUser string No Creado por el usuario.

createdDate string · date-time No Creado fecha.

price number · double No El precio.

tariffs JobTariff[] No Los aranceles.

Estructura de los elementos del array JobTariff

Campo	Tipo	Obligatorio	Descripción
`id`	integer · int64	No	Id.
`jobId`	integer · int32	No	Identificación de trabajo.
`price`	number · double	No	El precio.
`brandId`	integer · int32	No	Identificación de marca.
`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	No	Clasificación de categoría.
`categoryId`	integer · int32	No	Identificación de categoría.
`priority`	integer · int32	No	Prioridad.
`productId`	integer · int64	No	Identificación del producto.

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

Errores12

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required

Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied

Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown

Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_empty_category_class

No se ha especificado la clase

error específico de punto final. Utilice el código estable error_empty_category_class en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_job_price

No se especificó el precio para realizar el trabajo

error específico de punto final. Utilice el código estable error_empty_job_price en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_position

Cargo no especificado

error específico de punto final. Utilice el código estable error_empty_position en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_tariff_price

No se ha especificado el precio para la tarifa nº{position}

error específico de punto final. Utilice el código estable error_empty_tariff_price en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_tariff_priority

No se especificó la prioridad para la tarifa

error específico de punto final. Utilice el código estable error_empty_tariff_priority en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_tariffs

No se han especificado tarifas

error específico de punto final. Utilice el código estable error_empty_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_job_already_exists

La tarea con el nombre {jobName} ya existe

error específico de punto final. Utilice el código estable error_job_already_exists en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_job_tariff_wrong_product_id

Identificador de producto especificado incorrectamente: {id}

error específico de punto final. Utilice el código estable error_job_tariff_wrong_product_id en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client

Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

Flujos de trabajo listos para su uso

Comience a usar Job

Estructuras de datos

Cómo se devuelven los errores de aplicación

Puntos finales

Ponga trabajo

Parámetros de trayectoria

Organismo de solicitud

Respuesta exitosa

Quita a Job

Parámetros de trayectoria

Parámetros de consulta

Respuesta exitosa

Trabajo posterior

Organismo de solicitud

Respuesta exitosa

Token para las solicitudes de ensayo

Parámetros reales de la solicitud

Respuesta en vivo API