Models are listed once here and can also be expanded directly from the endpoints that use them.
Competitor6 fields
idinteger · int64
Id.
read-only
modelIdinteger · int64
Model Id.
servicestring
Service.
Required
urlstring
Url.
Required
serviceIdstring
Service Id.
clientIdinteger · int64
Client Id.
read-only
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_competitor_id_required
Competitor id is required
Endpoint-specific error. Use the stable error_competitor_id_required code in application logic; localMessage contains the translation shown above.
400error_competitor_required
Competitor is required
Endpoint-specific error. Use the stable error_competitor_required code in application logic; localMessage contains the translation shown above.
400error_competitor_service_required
Competitor service is required
Endpoint-specific error. Use the stable error_competitor_service_required code in application logic; localMessage contains the translation shown above.
400error_competitor_url_required
Competitor URL is required
Endpoint-specific error. Use the stable error_competitor_url_required 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.
DELETE
Delete
/api/competitor/{competitorId}
Token with write access
Delete using DELETE /api/competitor/{competitorId}.
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_competitor_id_required
Competitor id is required
Endpoint-specific error. Use the stable error_competitor_id_required 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.
GET
Get All
/api/competitor/{modelId}
Token with read access
Get All using GET /api/competitor/{modelId}.
Path parameters
Field
Type
Required
Description
modelId
integer · int64
Yes
Model Id.
curl --request GET 'https://api.selsup.ru/api/competitor/1001' \
--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_model_id_required
Model id is required
Endpoint-specific error. Use the stable error_model_id_required 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.
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_competitor_required
Competitor is required
Endpoint-specific error. Use the stable error_competitor_required code in application logic; localMessage contains the translation shown above.
400error_competitor_service_required
Competitor service is required
Endpoint-specific error. Use the stable error_competitor_service_required code in application logic; localMessage contains the translation shown above.
400error_competitor_url_required
Competitor URL is required
Endpoint-specific error. Use the stable error_competitor_url_required 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.