SelSup Developers

Public API · API Reference

Manufacturers

Endpoints for Manufacturers, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints/api/manufacturerStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/manufacturer

Ready-to-use workflows

Ready-to-use workflows

01

Start using Manufacturers

Use a dedicated API token and validate read operations with test data first.

  1. Keep the token server-side and send it in the Authorization header.
  2. Check required parameters and expand the request or response schema.
  3. Handle the HTTP status and the stable error field in application errors.

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

Manufacturer11 fields
manufacturerIdinteger · int32

Manufacturer Id.

titlestring

Title.

namestring

Name.

Required
addressstring

Address.

organizationIdinteger · int64

Organization Id.

clientIdinteger · int64

Client Id.

read-only
countryIdinteger · int32

Country Id.

countryNamestring

Country Name.

read-only
innstring

Inn.

deletedboolean

Deleted.

oneCIdstring

One CId.

FindResponseManufacturer1 fields
rowsManufacturer[]

Rows.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

GET

Get Manufacturer By Id

/api/manufacturer/{manufacturerId}
Token with read access

Get Manufacturer By Id using GET /api/manufacturer/{manufacturerId}.

Path parameters

FieldTypeRequiredDescription
manufacturerId integer · int32 Yes Manufacturer Id.
curl --request GET 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields Manufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One CId.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_manufacturer_not_found
Manufacturer not found: {id}

Endpoint-specific error. Use the stable error_manufacturer_not_found code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

PUT

Update Manufacturer

/api/manufacturer/{manufacturerId}
Token with write access

Update Manufacturer using PUT /api/manufacturer/{manufacturerId}.

Path parameters

FieldTypeRequiredDescription
manufacturerId integer · int64 Yes Manufacturer Id.

Request body

application/json
Object fieldsManufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One 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
}'

Success response

200
Object fields Manufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One CId.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_empty_manufacturer_name
Manufacturer name not specified

Endpoint-specific error. Use the stable error_empty_manufacturer_name code in application logic; localMessage contains the translation shown above.

400error_manufacturer_already_exist
There is already a manufacturer named {name}

Endpoint-specific error. Use the stable error_manufacturer_already_exist code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

DELETE

Remove Manufacturer

/api/manufacturer/{manufacturerId}
Token with write access

Remove Manufacturer using DELETE /api/manufacturer/{manufacturerId}.

Path parameters

FieldTypeRequiredDescription
manufacturerId integer · int32 Yes Manufacturer Id.

Query parameters

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

Success response

200
"string"
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Create Manufacturer

/api/manufacturer
Token with write access

Create Manufacturer using POST /api/manufacturer.

Request body

application/json
Object fieldsManufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One 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
}'

Success response

200
Object fields Manufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One CId.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_empty_manufacturer_name
Manufacturer name not specified

Endpoint-specific error. Use the stable error_empty_manufacturer_name code in application logic; localMessage contains the translation shown above.

400error_manufacturer_already_exist
There is already a manufacturer named {name}

Endpoint-specific error. Use the stable error_manufacturer_already_exist code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

GET

Find

/api/manufacturer/find
Token with read access

Find using GET /api/manufacturer/find.

Query parameters

FieldTypeRequiredDescription
query string No Query.
manufacturerOneCId string No Manufacturer One CId.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringMANUFACTURERID, NAME No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/manufacturer/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponseManufacturer
FieldTypeRequiredDescription
rows Manufacturer[] No Rows.
Array item structure Manufacturer
FieldTypeRequiredDescription
manufacturerId integer · int32 No Manufacturer Id.
title string No Title.
name string Yes Name.
address string No Address.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
countryId integer · int32 No Country Id.
countryName string No Country Name.
inn string No Inn.
deleted boolean No Deleted.
oneCId string No One CId.
{
  "rows": "string"
}
Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.