Public API · API Referencja

Wykonawcy

Punkty końcowe dla producentów, w tym dokładne trasy, parametry, organy żądania i rozszerzalne schematy odpowiedzi.

5 punkty końcowe/api/manufacturerStabilnyOpis czytelny maszynowo ↗

{ }

Strona ta jest wspierana przez edytowalny samodzielny kontrakt.

/api/manufacturer

Gotowe do użytkowania przepływy robocze

Zacznij używać Producenci

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.

GETZnajdź producenta według identyfikatu PUTAktualizacja Producent DELETEWykrycie

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ą.

Manufacturer11 pola

manufacturerIdinteger · int32

Idekcja producenta.

titlestring

Tytuł.

namestring

- Nazwa.

Wymagane

addressstring

- Adres.

organizationIdinteger · int64

Id organizacyjny.

clientIdinteger · int64

Id klientów.

read-only

countryIdinteger · int32

Id państwowy.

countryNamestring

Nazwa kraju.

read-only

innstring

- W hostażu.

deletedboolean

- Zlikwidowane.

oneCIdstring

Jeden CID.

FindResponseManufacturer1 pola

rowsManufacturer[]

Rzędy.

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

GET

Znajdź producenta według identyfikatu

/api/manufacturer/{manufacturerId}

Token z dostępem do odczytu

Uzyskaj identyfikację producenta za pomocą GET /api/manufacturer/{manufacturerId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Tak	Idekcja producenta.

curl --request GET 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/manufacturer/1001', {
  method: 'GET',
  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/manufacturer/1001', {
  method: 'GET',
  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.get(
    'https://api.selsup.ru/api/manufacturer/1001',
    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/manufacturer/1001',
    CURLOPT_CUSTOMREQUEST => 'GET',
    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("GET", "https://api.selsup.ru/api/manufacturer/1001", 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/manufacturer/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", 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

Połączenia obiektu Manufacturer

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Nie	Idekcja producenta.
`title`	string	Nie	Tytuł.
`name`	string	Tak	- Nazwa.
`address`	string	Nie	- Adres.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`clientId`	integer · int64	Nie	Id klientów.
`countryId`	integer · int32	Nie	Id państwowy.
`countryName`	string	Nie	Nazwa kraju.
`inn`	string	Nie	- W hostażu.
`deleted`	boolean	Nie	- Zlikwidowane.
`oneCId`	string	Nie	Jeden CID.

{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}

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_manufacturer_not_found

Nie znaleziono producenta: {id}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_manufacturer_not_found; 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.

PUT

Aktualizacja Producent

/api/manufacturer/{manufacturerId}

Token z dostępem do pisania

Aktualizacja Producent używający PUT /api/manufacturer/{manufacturerId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int64	Tak	Idekcja producenta.

Organ wnioskujący

application/json

Połączenia obiektuManufacturer

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Nie	Idekcja producenta.
`title`	string	Nie	Tytuł.
`name`	string	Tak	- Nazwa.
`address`	string	Nie	- Adres.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`clientId`	integer · int64	Nie	Id klientów.
`countryId`	integer · int32	Nie	Id państwowy.
`countryName`	string	Nie	Nazwa kraju.
`inn`	string	Nie	- W hostażu.
`deleted`	boolean	Nie	- Zlikwidowane.
`oneCId`	string	Nie	Jeden CID.

curl --request PUT 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/manufacturer/1001', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "manufacturerId": 1001,
    "title": "Example",
    "address": "string",
    "organizationId": 1001,
    "clientId": 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/manufacturer/1001', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "manufacturerId": 1001,
    "title": "Example",
    "address": "string",
    "organizationId": 1001,
    "clientId": 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/manufacturer/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Example',
        'manufacturerId': 1001,
        'title': 'Example',
        'address': 'string',
        'organizationId': 1001,
        'clientId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/manufacturer/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/manufacturer/1001", strings.NewReader(`{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 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/manufacturer/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 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 Manufacturer

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Nie	Idekcja producenta.
`title`	string	Nie	Tytuł.
`name`	string	Tak	- Nazwa.
`address`	string	Nie	- Adres.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`clientId`	integer · int64	Nie	Id klientów.
`countryId`	integer · int32	Nie	Id państwowy.
`countryName`	string	Nie	Nazwa kraju.
`inn`	string	Nie	- W hostażu.
`deleted`	boolean	Nie	- Zlikwidowane.
`oneCId`	string	Nie	Jeden CID.

{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}

Władze7

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_manufacturer_name

Nie podano nazwy producenta

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

400error_manufacturer_already_exist

Producent o nazwie {name} już istnieje

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_manufacturer_already_exist; 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

Wykrycie

/api/manufacturer/{manufacturerId}

Token z dostępem do pisania

Wyjmowanie Producent używając DELETE /api/manufacturer/{manufacturerId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Tak	Idekcja producenta.

Parametry zapytania

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

curl --request DELETE 'https://api.selsup.ru/api/manufacturer/1001?deleted=false' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/manufacturer/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/manufacturer/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/manufacturer/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/manufacturer/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/manufacturer/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/manufacturer/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ładze3

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.

POST

Tworzenie Producenta

/api/manufacturer

Token z dostępem do pisania

Utworzenie Producenta za pomocą POST /api/manufacturer.

Organ wnioskujący

application/json

Połączenia obiektuManufacturer

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Nie	Idekcja producenta.
`title`	string	Nie	Tytuł.
`name`	string	Tak	- Nazwa.
`address`	string	Nie	- Adres.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`clientId`	integer · int64	Nie	Id klientów.
`countryId`	integer · int32	Nie	Id państwowy.
`countryName`	string	Nie	Nazwa kraju.
`inn`	string	Nie	- W hostażu.
`deleted`	boolean	Nie	- Zlikwidowane.
`oneCId`	string	Nie	Jeden CID.

curl --request POST 'https://api.selsup.ru/api/manufacturer' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/manufacturer', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "manufacturerId": 1001,
    "title": "Example",
    "address": "string",
    "organizationId": 1001,
    "clientId": 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/manufacturer', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "manufacturerId": 1001,
    "title": "Example",
    "address": "string",
    "organizationId": 1001,
    "clientId": 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/manufacturer',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Example',
        'manufacturerId': 1001,
        'title': 'Example',
        'address': 'string',
        'organizationId': 1001,
        'clientId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/manufacturer',
    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/manufacturer", strings.NewReader(`{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 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/manufacturer"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 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 Manufacturer

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Nie	Idekcja producenta.
`title`	string	Nie	Tytuł.
`name`	string	Tak	- Nazwa.
`address`	string	Nie	- Adres.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`clientId`	integer · int64	Nie	Id klientów.
`countryId`	integer · int32	Nie	Id państwowy.
`countryName`	string	Nie	Nazwa kraju.
`inn`	string	Nie	- W hostażu.
`deleted`	boolean	Nie	- Zlikwidowane.
`oneCId`	string	Nie	Jeden CID.

{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}

Władze7

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_manufacturer_name

Nie podano nazwy producenta

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

400error_manufacturer_already_exist

Producent o nazwie {name} już istnieje

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_manufacturer_already_exist; 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.

GET

Znajdź

/api/manufacturer/find

Token z dostępem do odczytu

Znajdź używając GET /api/manufacturer/find.

Parametry zapytania

Pole	Typ	Wymagane	Opis
`query`	string	Nie	- Nie wiem.
`manufacturerOneCId`	string	Nie	Producent 1 CId.
`limit`	integer · int32	Nie	Ogranicz.
`page`	integer · int32	Nie	Strona.
`count`	boolean	Nie	Zgromadzisz.
`sortBy`	stringMANUFACTURERID, NAME	Nie	- Zarejestrowany.
`ascending`	boolean	Nie	Wzniesienie.

curl --request GET 'https://api.selsup.ru/api/manufacturer/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/manufacturer/find?limit=50&page=1', {
  method: 'GET',
  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/manufacturer/find?limit=50&page=1', {
  method: 'GET',
  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.get(
    'https://api.selsup.ru/api/manufacturer/find?limit=50&page=1',
    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/manufacturer/find?limit=50&page=1',
    CURLOPT_CUSTOMREQUEST => 'GET',
    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("GET", "https://api.selsup.ru/api/manufacturer/find?limit=50&page=1", 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/manufacturer/find?limit=50&page=1"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", 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

Połączenia obiektu FindResponseManufacturer

Pole Typ Wymagane Opis

rows Manufacturer[] Nie Rzędy.

Struktura pozycji zestawu Manufacturer

Pole	Typ	Wymagane	Opis
`manufacturerId`	integer · int32	Nie	Idekcja producenta.
`title`	string	Nie	Tytuł.
`name`	string	Tak	- Nazwa.
`address`	string	Nie	- Adres.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`clientId`	integer · int64	Nie	Id klientów.
`countryId`	integer · int32	Nie	Id państwowy.
`countryName`	string	Nie	Nazwa kraju.
`inn`	string	Nie	- W hostażu.
`deleted`	boolean	Nie	- Zlikwidowane.
`oneCId`	string	Nie	Jeden CID.

{
  "rows": "string"
}

Władze5

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_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.

Wykonawcy

Gotowe do użytkowania przepływy robocze

Zacznij używać Producenci

Struktura danych

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

Punkty końcowe

Znajdź producenta według identyfikatu

Parametry ścieżki

Odpowiedź udana

Aktualizacja Producent

Parametry ścieżki

Organ wnioskujący

Odpowiedź udana

Wykrycie

Parametry ścieżki

Parametry zapytania

Odpowiedź udana

Tworzenie Producenta

Organ wnioskujący

Odpowiedź udana

Znajdź

Parametry zapytania

Odpowiedź udana

Token do wniosków o badania

Prawdziwe parametry żądania

Odpowiedź API