Getting a list of companies.
offset | integer <int32> [ 0 .. 10000000 ] Default: 0 Example: offset=10 The number of items to skip before starting to collect the result set. |
limit | integer <int32> [ 1 .. 10000000 ] Default: 100 Example: limit=10 The number of items to return. |
filter | string [ 1 .. 64 ] characters Example: filter=example text Filter for searching by text fields. |
sort_field | string [ 1 .. 64 ] characters Example: sort_field=name Field to sort by. |
sort_direction | string Default: "ASC" Enum: "ASC" "DESC" Example: sort_direction=DESC Sort direction. |
required | Array of objects (company) [ 0 .. 10000000 ] items A list of companies. |
required | object (company_list_counters) Statistics by company list. |
{- "companies": [
- {
- "key": "smart_company",
- "specification": "Company full name"
}
], - "counters": {
- "overall": {
- "total": 1
}, - "filter": {
- "total": 1
}
}
}
New company creation.
Company creation request.
key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
specification | string or null [ 2 .. 256 ] characters Default: null Example: "Company full name" Company specification. |
key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
specification | string or null [ 2 .. 256 ] characters Default: null Example: "Company full name" Company specification. |
{- "key": "smart_company",
- "specification": "Company full name"
}
{- "key": "smart_company",
- "specification": "Company full name"
}
Updating the company information.
Company update request.
key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
specification | string or null [ 2 .. 256 ] characters Default: null Example: "Company full name" Company specification. |
key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
specification | string or null [ 2 .. 256 ] characters Default: null Example: "Company full name" Company specification. |
{- "key": "smart_company",
- "specification": "Company full name"
}
{- "key": "smart_company",
- "specification": "Company full name"
}
Getting company information by key.
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: smart_company Parameter (path) with company key. |
key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
specification | string or null [ 2 .. 256 ] characters Default: null Example: "Company full name" Company specification. |
{- "key": "smart_company",
- "specification": "Company full name"
}
Removing a company by key.
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: smart_company Parameter (path) with company key. |
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}, - "message": "Bad Request"
}
Getting a list of users.
offset | integer <int32> [ 0 .. 10000000 ] Default: 0 Example: offset=10 The number of items to skip before starting to collect the result set. |
limit | integer <int32> [ 1 .. 10000000 ] Default: 100 Example: limit=10 The number of items to return. |
filter | string [ 1 .. 64 ] characters Example: filter=example text Filter for searching by text fields. |
sort_field | string [ 1 .. 64 ] characters Example: sort_field=name Field to sort by. |
sort_direction | string Default: "ASC" Enum: "ASC" "DESC" Example: sort_direction=DESC Sort direction. |
company_key | string (company_key) [ 3 .. 256 ] characters \w+ Example: company_key=smart_company Parameter (query) with company key. |
user_group | string (user_groups) Default: "TOTAL" Enum: "TOTAL" "ACTIVE" "BLOCKED" … 1 more Example: user_group=ACTIVE Users logic groups. |
required | Array of objects (user) [ 0 .. 10000000 ] items A list of users. |
required | object (user_list_counters) Statistics by users list. |
{- "users": [
- {
- "username": "username_for_login",
- "specification": "User full name",
- "email": "admin@company.com",
- "phone": "+71112223333",
- "company_key": "smart_company",
- "enabled": true,
- "roles": [
- "USER"
], - "timezone": 3,
- "edit_date": "2024-11-21T19:45:00Z",
- "creation_date": "2024-11-21T19:45:00Z",
- "attributes": [ ]
}
], - "counters": {
- "overall": {
- "total": 1,
- "active": 1,
- "blocked": 1,
- "admins": 1
}, - "filter": {
- "total": 1,
- "active": 1,
- "blocked": 1,
- "admins": 1
}
}
}
New user creation.
User creation request.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login. |
password | string or null <password> (user_password) [ 10 .. 256 ] characters Example: "long_strong_password" Password. |
specification | string or null (user_specification) [ 2 .. 256 ] characters Example: "User full name" User specification. |
string or null <email> (user_email) [ 5 .. 256 ] characters Example: "admin@company.com" User e-mail address. | |
phone | string or null (user_phone) [ 5 .. 32 ] characters Example: "+71112223333" User phone. |
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
enabled | boolean Default: true Example: "true" User status. |
roles required | Array of strings (user_role_list) [ 0 .. 2 ] items unique Items Enum: "ADMIN" "PARTNER" "USER" … 1 more Example: "USER" List of user roles. |
timezone | integer <int32> (timezone) [ -12 .. 12 ] Example: "3" Basic time zone used for statistics. |
Array of objects (attributes) [ 0 .. 1000 ] items unique Attributes. Used to add service information. |
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login. |
specification | string or null (user_specification) [ 2 .. 256 ] characters Example: "User full name" User specification. |
string or null <email> (user_email) [ 5 .. 256 ] characters Example: "admin@company.com" User e-mail address. | |
phone | string or null (user_phone) [ 5 .. 32 ] characters Example: "+71112223333" User phone. |
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
enabled | boolean Default: true Example: "true" User status. |
roles required | Array of strings (user_role_list) [ 0 .. 2 ] items unique Items Enum: "ADMIN" "PARTNER" "USER" … 1 more Example: "USER" List of user roles. |
timezone | integer <int32> (timezone) [ -12 .. 12 ] Example: "3" Basic time zone used for statistics. |
edit_date | string or null <date-time> Default: null Example: "2024-11-21T19:45:00Z" Last edit date and time in the ISO 8601 format. |
creation_date | string or null <date-time> Default: null Example: "2024-11-21T19:45:00Z" Creation date and time in the ISO 8601 format. |
Array of objects (attributes) [ 0 .. 1000 ] items unique Attributes. Used to add service information. |
{- "username": "username_for_login",
- "password": "long_strong_password",
- "specification": "User full name",
- "email": "admin@company.com",
- "phone": "+71112223333",
- "company_key": "smart_company",
- "enabled": true,
- "roles": [
- "USER"
], - "timezone": 3,
- "attributes": [ ]
}
{- "username": "username_for_login",
- "specification": "User full name",
- "email": "admin@company.com",
- "phone": "+71112223333",
- "company_key": "smart_company",
- "enabled": true,
- "roles": [
- "USER"
], - "timezone": 3,
- "edit_date": "2024-11-21T19:45:00Z",
- "creation_date": "2024-11-21T19:45:00Z",
- "attributes": [ ]
}
Updating the user information by login. The username field cannot be changed.
User update request.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login. |
password | string or null <password> (user_password) [ 10 .. 256 ] characters Example: "long_strong_password" Password. |
specification | string or null (user_specification) [ 2 .. 256 ] characters Example: "User full name" User specification. |
string or null <email> (user_email) [ 5 .. 256 ] characters Example: "admin@company.com" User e-mail address. | |
phone | string or null (user_phone) [ 5 .. 32 ] characters Example: "+71112223333" User phone. |
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
enabled | boolean Default: true Example: "true" User status. |
roles required | Array of strings (user_role_list) [ 0 .. 2 ] items unique Items Enum: "ADMIN" "PARTNER" "USER" … 1 more Example: "USER" List of user roles. |
timezone | integer <int32> (timezone) [ -12 .. 12 ] Example: "3" Basic time zone used for statistics. |
Array of objects (attributes) [ 0 .. 1000 ] items unique Attributes. Used to add service information. |
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login. |
specification | string or null (user_specification) [ 2 .. 256 ] characters Example: "User full name" User specification. |
string or null <email> (user_email) [ 5 .. 256 ] characters Example: "admin@company.com" User e-mail address. | |
phone | string or null (user_phone) [ 5 .. 32 ] characters Example: "+71112223333" User phone. |
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
enabled | boolean Default: true Example: "true" User status. |
roles required | Array of strings (user_role_list) [ 0 .. 2 ] items unique Items Enum: "ADMIN" "PARTNER" "USER" … 1 more Example: "USER" List of user roles. |
timezone | integer <int32> (timezone) [ -12 .. 12 ] Example: "3" Basic time zone used for statistics. |
edit_date | string or null <date-time> Default: null Example: "2024-11-21T19:45:00Z" Last edit date and time in the ISO 8601 format. |
creation_date | string or null <date-time> Default: null Example: "2024-11-21T19:45:00Z" Creation date and time in the ISO 8601 format. |
Array of objects (attributes) [ 0 .. 1000 ] items unique Attributes. Used to add service information. |
{- "username": "username_for_login",
- "password": "long_strong_password",
- "specification": "User full name",
- "email": "admin@company.com",
- "phone": "+71112223333",
- "company_key": "smart_company",
- "enabled": true,
- "roles": [
- "USER"
], - "timezone": 3,
- "attributes": [ ]
}
{- "username": "username_for_login",
- "specification": "User full name",
- "email": "admin@company.com",
- "phone": "+71112223333",
- "company_key": "smart_company",
- "enabled": true,
- "roles": [
- "USER"
], - "timezone": 3,
- "edit_date": "2024-11-21T19:45:00Z",
- "creation_date": "2024-11-21T19:45:00Z",
- "attributes": [ ]
}
Getting user information by login.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: username_for_login Parameter (path) with username. |
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login. |
specification | string or null (user_specification) [ 2 .. 256 ] characters Example: "User full name" User specification. |
string or null <email> (user_email) [ 5 .. 256 ] characters Example: "admin@company.com" User e-mail address. | |
phone | string or null (user_phone) [ 5 .. 32 ] characters Example: "+71112223333" User phone. |
company_key required | string (company_key) [ 3 .. 256 ] characters \w+ Example: "smart_company" Unique company key. |
enabled | boolean Default: true Example: "true" User status. |
roles required | Array of strings (user_role_list) [ 0 .. 2 ] items unique Items Enum: "ADMIN" "PARTNER" "USER" … 1 more Example: "USER" List of user roles. |
timezone | integer <int32> (timezone) [ -12 .. 12 ] Example: "3" Basic time zone used for statistics. |
edit_date | string or null <date-time> Default: null Example: "2024-11-21T19:45:00Z" Last edit date and time in the ISO 8601 format. |
creation_date | string or null <date-time> Default: null Example: "2024-11-21T19:45:00Z" Creation date and time in the ISO 8601 format. |
Array of objects (attributes) [ 0 .. 1000 ] items unique Attributes. Used to add service information. |
{- "username": "username_for_login",
- "specification": "User full name",
- "email": "admin@company.com",
- "phone": "+71112223333",
- "company_key": "smart_company",
- "enabled": true,
- "roles": [
- "USER"
], - "timezone": 3,
- "edit_date": "2024-11-21T19:45:00Z",
- "creation_date": "2024-11-21T19:45:00Z",
- "attributes": [ ]
}
Removing a user by login.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: username_for_login Parameter (path) with username. |
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}, - "message": "Bad Request"
}
User actions for the period. If the period is not specified, records for the current day are returned from the beginning of the day to the current time. If username is empty, report on all users are processed.
company_key | string (company_key) [ 3 .. 256 ] characters \w+ Example: company_key=smart_company Parameter (query) with company key. |
username | string (user_username) [ 2 .. 256 ] characters \w+ Example: username=username_for_login Parameter (query) with username. |
offset | integer <int32> [ 0 .. 10000000 ] Default: 0 Example: offset=10 The number of items to skip before starting to collect the result set. |
limit | integer <int32> [ 1 .. 10000000 ] Default: 100 Example: limit=10 The number of items to return. |
from | string <date-time> Example: from=2024-11-21T09:30:00+03:00 Date and time in the ISO 8601 format. If no datetime is specified, audit data are returned from the beginning of the day. |
to | string <date-time> Example: to=2024-11-21T18:00:00+03:00 Date and time in the ISO 8601 format. If not specified, data up to the current time is returned. |
service | string (service) Enum: "UNIVERSAL" "ROUTING" "ACCOUNT" … 5 more Example: service=UNIVERSAL Service name. |
operation | string (operation) [ 3 .. 256 ] characters \w+ Example: operation=run_plan_calculation Operation name. |
process_type | string (process_type) Enum: "NOTRACE" "TRACE" "PLAN" … 4 more Example: process_type=PLAN Process type. |
status | string (calculation_status) Enum: "WAITING" "IN_PROGRESS" "FINISHED_IN_TIME" … 5 more Example: status=FINISHED_IN_TIME Process status. |
sort_field | string [ 1 .. 64 ] characters Example: sort_field=name Field to sort by. |
sort_direction | string Default: "ASC" Enum: "ASC" "DESC" Example: sort_direction=DESC Sort direction. |
required | Array of objects (audit_action) [ 0 .. 10000000 ] items User audit data list. |
required | object (audit_counters) Counters by records list. |
{- "actions": [
- {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "process_type": "PLAN",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "time": "2024-11-21T09:30:00+03:00",
- "requests": [
- {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}
], - "statistics": {
- "request_points_count": 1500,
- "result_elements_count": 500,
- "calculation_info": {
- "status": "FINISHED_IN_TIME",
- "result_version": 133,
- "preparing_time": "PT1H45M",
- "business_validation_time": "PT1H45M",
- "math_validation_time": "PT1H45M",
- "waiting_time": "PT1H45M",
- "calculation_time": "PT1H45M"
}
}, - "input_file_exists": true,
- "output_file_exists": true
}
], - "counters": {
- "overall": {
- "total": 1
}, - "filter": {
- "total": 1
}
}
}
Receiving an incoming request by tracedata.process_code
.
process_code required | string <uuid> (process_code) Example: 11111111-2222-3333-4444-555555555555 Unique process identifier. |
data_flow_type | string (flow_type) Default: "INPUT" Enum: "INPUT" "OUTPUT" Example: data_flow_type=OUTPUT Data flow type. |
data_flow_stage | string Default: "RAW" Value: "RAW" Example: data_flow_stage=RAW Data flow stage. |
File with data (octet-stream).
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}, - "message": "Bad Request"
}
User statistics for the period. If username is empty, statistics on all users are processed. If the period is not specified, the statistics for the current month returns (from the beginning of the month to the present day). If no from
datetime is specified, data are returned from the beginning of the month. If no to
datetime is specified, data are returned be to the present day (excluding). Empty service and process type fields mean returning statistics for all services and process types.
username | string (user_username) [ 2 .. 256 ] characters \w+ Example: username=username_for_login Parameter (query) with username. |
from | string <date> Example: from=2024-11-22 Date |
to | string <date> Example: to=2024-11-26 Date |
service | string (service) Enum: "UNIVERSAL" "ROUTING" "ACCOUNT" … 5 more Example: service=UNIVERSAL Service name. |
process_type | string (process_type) Enum: "NOTRACE" "TRACE" "PLAN" … 4 more Example: process_type=PLAN Process type. |
required | Array of objects (user_statistics) [ 0 .. 10000000 ] items User statistics list. |
{- "users": [
- {
- "username": "user_one",
- "dates": [
- {
- "date": "2024-11-15",
- "services": [
- {
- "service": "UNIVERSAL",
- "processes": [
- {
- "process_type": "PLAN",
- "unique_points_per_day": 1,
- "points_per_day": 2,
- "elements_per_day": 1,
- "processes_per_day": 1
}
]
}
]
}
]
}
]
}
Report by user for the period. If username is empty, report on all users are processed. If the period is not specified, the report for the current month returns (from the beginning of the month to the present day). If no from
datetime is specified, data are returned from the beginning of the month. If no to
datetime is specified, data are returned be to the present day (excluding). Empty service and process type fields mean returning statistics for all services and process types.
username | string (user_username) [ 2 .. 256 ] characters \w+ Example: username=username_for_login Parameter (query) with username. |
from | string <date> Example: from=2024-11-22 Date |
to | string <date> Example: to=2024-11-26 Date |
service | string (service) Enum: "UNIVERSAL" "ROUTING" "ACCOUNT" … 5 more Example: service=UNIVERSAL Service name. |
process_type | string (process_type) Enum: "NOTRACE" "TRACE" "PLAN" … 4 more Example: process_type=PLAN Process type. |
File with data in XLSX format.
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}, - "message": "Bad Request"
}
Setting the quotas for the user.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: username_for_login Parameter (path) with username. |
Request to change the quota.
required | Array of objects (service_quota) [ 1 .. 8 ] items unique All services quota list. |
{- "services": [
- {
- "service": "UNIVERSAL",
- "processes": [
- {
- "process_type": "PLAN",
- "points_per_request": 1500,
- "points_per_day": 25000,
- "max_concurrent_execution": 5
}
]
}
]
}
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}, - "message": "Bad Request"
}
Obtaining the quotas for the user.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: username_for_login Parameter (path) with username. |
required | object (quota_base) All services quota. |
{- "base": {
- "services": [
- {
- "service": "UNIVERSAL",
- "processes": [
- {
- "process_type": "PLAN",
- "points_per_request": 1500,
- "points_per_day": 25000,
- "max_concurrent_execution": 5
}
]
}
]
}
}
Quota removal for the user.
username required | string (user_username) [ 2 .. 256 ] characters \w+ Example: username_for_login Parameter (path) with username. |
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}, - "message": "Bad Request"
}
Checking the service availability.
health required | number <double> [ 0 .. 1 ] Example: "0.999" The current health indicator of the service.
|
{- "health": 0.999
}
Getting the service version.
major required | integer <int32> [ 1 .. 100 ] Example: "7" Product version. Within a single version, compatibility of common data structures between services is guaranteed. A version change indicates changes that are incompatible with previous versions of the product (and all services). |
minor required | integer <int32> [ 0 .. 111 ] Example: "15" Minor version of the service. A version change indicates new functionality. The update is backward compatible with the major version of the service. |
build required | string [ 1 .. 64 ] characters Example: "3754RC" Build version. |
{- "major": 7,
- "minor": 15,
- "build": "3754RC"
}
Getting the file with this service documentation.
filename required | string [ 6 .. 128 ] characters Example: file_en.html File name. |
File with data in HTML format.
{- "resource_key": "resource_key",
- "detail": {
- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}
}
}