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"
}
}
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}.
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}.
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.
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
Field
Type
Required
Description
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'
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.