VRt.Account [AC] (7.13.2613)

Veeroute Support Team: servicedesk@veeroute.com License: Proprietary Terms of Service

公司网站 Veeroute

Description

Veeroute Account Panel.

Entity relationship diagram

erd

Auth

授权。

Obtaining a token

Obtaining a token using the login and password.

Request Body schema: application/json
required

Token request.

username required	string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login.
password required	string or null <password> (user_password) [ 10 .. 256 ] characters Example: "long_strong_password" Password.
ttl_seconds	integer <int32> [ 60 .. 31556926 ] Default: 86400 Example: "86400" Token validity time, in seconds.

Responses

Response Schema: application/json

string (token) [ 10 .. 1000 ] characters

Token (JWT).

Request samples

Payload

Content type

application/json

{"username": "username_for_login",
"password": "long_strong_password",
"ttl_seconds": 86400
}

Response samples

Content type

application/json

"new.jwt.token"

Validating a token

Validating a token.

Request Body schema: application/json
required

Token validate request.

string (token) [ 10 .. 1000 ] characters

Token (JWT).

Responses

Response Schema: application/json

valid required	boolean Example: "true" Token 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.

Request samples

Payload

Content type

application/json

"new.jwt.token"

Response samples

Content type

application/json

{"valid": true,
"roles": ["USER"
]
}

Change password

Change password and get new token.

Authorizations:

ApiKeyAuth

Request Body schema: application/json
optional

Password change request data.

current_password required	string or null <password> (user_password) [ 10 .. 256 ] characters Example: "long_strong_password" Password.
new_password required	string or null <password> (user_password) [ 10 .. 256 ] characters Example: "long_strong_password" Password.

Responses

Response Schema: application/json

string (token) [ 10 .. 1000 ] characters

Token (JWT).

Request samples

Payload

Content type

application/json

{"current_password": "long_strong_password",
"new_password": "long_strong_password"
}

Response samples

Content type

application/json

"new.jwt.token"

Info

帐户信息。

Account information

Getting a account information.

Authorizations:

ApiKeyAuth

Responses

Response Schema: application/json

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.
email	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: "2025-03-21T19:45:00Z" Last edit date and time in the ISO 8601 format.
creation_date	string or null <date-time> Default: null Example: "2025-03-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.

Response samples

Content type

application/json

{"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": "2025-03-21T19:45:00Z",
"creation_date": "2025-03-21T19:45:00Z",
"attributes": [ ]
}

Account update

Updating the account information.

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

Account update request.

specification	string or null (user_specification) [ 2 .. 256 ] characters Example: "User full name" User specification.
email	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.
	Array of objects (attributes) [ 0 .. 1000 ] items unique Attributes. Used to add service information.

Responses

Response Schema: application/json

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.
email	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: "2025-03-21T19:45:00Z" Last edit date and time in the ISO 8601 format.
creation_date	string or null <date-time> Default: null Example: "2025-03-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.

Request samples

Payload

Content type

application/json

{"specification": "User full name",
"email": "admin@company.com",
"phone": "+71112223333",
"attributes": [ ]
}

Response samples

Content type

application/json

{"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": "2025-03-21T19:45:00Z",
"creation_date": "2025-03-21T19:45:00Z",
"attributes": [ ]
}

Statistics

统计数据。

Statistics for the period

User statistics for the period. 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.

Authorizations:

ApiKeyAuth

query Parameters

from	string <date> Example: from=2025-03-22 Date `from` in the YYYY-MM-DD format.
to	string <date> Example: to=2025-03-26 Date `to` (including) in the YYYY-MM-DD format.
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.

Responses

Response Schema: application/json

username required	string (user_username) [ 2 .. 256 ] characters \w+ Example: "username_for_login" Unique username for login.
required	Array of objects (date_statistics) [ 0 .. 3653 ] items Statistics list for each day for the specified user.

Response samples

Content type

application/json

{"username": "username_for_login",
"dates": [{"date": "2025-03-05",
"services": [{"service": "UNIVERSAL",
"processes": [{"process_type": "PLAN",
"unique_points_per_day": 1500,
"points_per_day": 2500,
"elements_per_day": 2500,
"processes_per_day": 776
}
]
}
]
}
]
}

Report creating

Creating report with usage statistics. If the period is not specified, records are returned from the beginning of the month to the present day (excluding). 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 the the present day (excluding). Empty service and process type fields mean returning statistics for all services and process types.

Authorizations:

ApiKeyAuth

query Parameters

from	string <date> Example: from=2025-03-22 Date `from` in the YYYY-MM-DD format.
to	string <date> Example: to=2025-03-26 Date `to` (including) in the YYYY-MM-DD format.
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.

Responses

Response Schema: application/octet-stream

string <byte> (file_xlsx)

File with data in XLSX format.

Response samples

400
402
403
429
500

Content type

application/json

{"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": "2025-03-21T09:30:00+03:00"
},
"message": "Bad Request",
"schema_errors": [{"entity": "order_0001",
"message": "bad input data"
}
]
}

Audit

用户操作。

Actions for the period

User actions for the period. If the period is not specified, data for the current day is returned - from the beginning of the day to the current time inclusive. If the beginning of the time period is not specified, data from the beginning of the current day is returned. If the end of the time period is not specified, data up to the current time is returned.

Authorizations:

ApiKeyAuth

query Parameters

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=2025-03-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=2025-03-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.

Responses

Response Schema: application/json

required	Array of objects (audit_action) [ 0 .. 10000000 ] items User actions list.
required	object (audit_counters) Counters by records list.

Response samples

Content type

application/json

{"actions": [{"process_code": "11111111-2222-3333-4444-555555555555",
"process_type": "PLAN",
"username": "username_for_login",
"company": "smart_company",
"service": "UNIVERSAL",
"time": "2025-03-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": "2025-03-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
}
}
}

Data

User data.

Reading data

Receiving data by tracedata.process_code.

Authorizations:

ApiKeyAuth

path Parameters

process_code

required

string <uuid> (process_code)

Example: 11111111-2222-3333-4444-555555555555

唯一的进程标识符。

query Parameters

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.

Responses

Response Schema: application/octet-stream

string <byte> (file_binary)

File with data (octet-stream).

Response samples

Content type

application/json

{"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": "2025-03-21T09:30:00+03:00"
},
"message": "Bad Request",
"schema_errors": [{"entity": "order_0001",
"message": "bad input data"
}
]
}

Quota

Quota.

Obtaining the quotas

Obtaining the quotas for the user.

Authorizations:

ApiKeyAuth

Responses

Response Schema: application/json

required

object (quota_base)

All services quota.

Response samples

Content type

application/json

{"base": {"services": [{"service": "UNIVERSAL",
"processes": [{"process_type": "PLAN",
"points_per_request": 1500,
"points_per_day": 25000,
"max_concurrent_execution": 5
}
]
}
]
}
}

System

系统功能。所有服务共有的辅助功能。

检查服务可用性

检查服务可用性。

Responses

Response Schema: application/json

health

required

number <double> [ 0 .. 1 ]

Example: "0.999"

The current health indicator of the service.

0.0 means the service is not ready to perform tasks.
1.0 means the service is fully ready to perform tasks.

Response samples

200
404
429
500

Content type

application/json

{"health": 0.999
}

获取服务版本

获取服务版本。

Responses

Response Schema: application/json

major required	integer <int32> [ 1 .. 100 ] Example: "7" 产品版本。在单个版本中，保证了服务之间通用数据结构的兼容性。版本更改表示与以前版本的产品（和所有服务）不兼容的更改。
minor required	integer <int32> [ 0 .. 111 ] Example: "15" 服务的小版本。版本更改表示新功能。该更新向后兼容服务的主要版本。
build required	string [ 1 .. 64 ] characters Example: "3754RC" 构建版本。包含向后兼容的错误修复和文档更新。

Response samples

200
404
429
500

Content type

application/json

{"major": 7,
"minor": 15,
"build": "3754RC"
}

检查服务可用性

检查服务可用性。

path Parameters

filename

required

string [ 6 .. 128 ] characters

Example: file_en.html

File name.

Responses

Response Schema:
text/html

string (file_html)

File with data in HTML format.

Response samples

404
429
500

Content type

application/json

{"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": "2025-03-21T09:30:00+03:00"
}
}
}

VRt.Account [AC] (7.13.2613)

Description

Entity relationship diagram

Auth

Obtaining a token

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Validating a token

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Change password

Authorizations:

Request Body schema: application/jsonoptional

Responses

Response Schema: application/json

Request samples

Response samples

Info

Account information

Authorizations:

Responses

Response Schema: application/json

Response samples

Account update

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Statistics

Statistics for the period

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Report creating

Authorizations:

query Parameters

Responses

Response Schema: application/octet-stream

Response samples

Audit

Actions for the period

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Data

Reading data

Authorizations:

path Parameters

query Parameters

Responses

Response Schema: application/octet-stream

Response samples

Quota

Obtaining the quotas

Authorizations:

Responses

Response Schema: application/json

Response samples

System

检查服务可用性

Responses

Response Schema: application/json

Response samples

获取服务版本

Responses

Response Schema: application/json

Response samples

检查服务可用性

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
optional

Request Body schema: application/json
required

Response Schema:
text/html