Luna-Admin API (v.4.2.7)

Download OpenAPI specification:Download

VisionLabs Luna Admin API.

OpenAPI specification is the only valid document providing up-to-date information about the service API.

The specification can be used:

  • By documentation generation tools to visualize the API.
  • By code generation tools.

All the documents and code generated using this specification can include inaccuracies and should be carefully checked.

OpenAPI specification can be received using the "/docs/spec" resource. The "Accept" header should be set to "application/x-yaml".

Authentication

BasicAuth

Security Scheme Type HTTP
HTTP Authorization Scheme basic

views

get account info tables

account info form. if authorization is not passed redirection to /login page occurs

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

view version

version form.

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

log in

authorization form. if authorization is passed redirection to home page occurs

Authorizations:
header Parameters
Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

get account info tables

account info form

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

get account info by id

specified account info form

Authorizations:
path Parameters
account_id
required
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

account id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

get account lists

specified account lists form

Authorizations:
path Parameters
account_id
required
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

account id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

get task info tables

task info form

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/html
<html><body>some content</body></html>

help

get version

get versions of luna service

Authorizations:
header Parameters
Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "api": 3,
  • "major": 2,
  • "minor": 0,
  • "patch": 1
}

get system info

get luna system info

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "services_versions": {
    },
  • "descriptor_info": [
    ],
  • "configs": {
    },
  • "current_faces_attributes_count": 10,
  • "license_info": {
    }
}

login

check authorization

check authorization cookie

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
text/plain
Ok

set authorization

set authorization cookie

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
Example
{
  • "error_code": 12010,
  • "desc": "Bad/incomplete input data",
  • "detail": "This resource needs 'Authorization' authorization headers"
}

change authorization

change authorization cookie

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Request Body schema: application/json
password
string <= 4096 characters

a new password.

Responses

Request samples

Content type
application/json
{
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "error_code": 12002,
  • "desc": "Bad/incomplete input data",
  • "detail": "Request does not contain json"
}

clear authorization

clear authorization cookie

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
Example
{
  • "error_code": 12010,
  • "desc": "Bad/incomplete input data",
  • "detail": "This resource needs 'Authorization' authorization headers"
}

search

search element by id or email

search element by id or email

Authorizations:
query Parameters
id (string) or email (string)
Example: q=557d54ec-29ad-4f3c-93b4-c9092ef12515

specify the id of an element or the e-mail of an account.

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "type": "account"
}

accounts

get accounts

get accounts with filters

Authorizations:
query Parameters
page
integer >= 1
Default: 1
Example: page=146

a page number.

page_size
integer [ 1 .. 100 ]
Default: 10
Example: page_size=146

the number of items on page.

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "accounts": [
    ],
  • "account_count": 0
}

register account

register a new account in the system

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Content-Type
string
Value: "application/json"
Request Body schema: application/json
email
required
string <email> (email) <= 64 characters ^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-...

email address.

organization_name
required
string (organization_name) <= 128 characters

organization name.

Responses

Request samples

Content type
application/json
{
  • "email": "horns@hooves.com",
  • "organization_name": "Horns and Hooves"
}

Response samples

Content type
application/json
{
  • "account_id": "string"
}

get account by id

get account info by account id

Authorizations:
path Parameters
account_id
required
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

account id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "info": {
    },
  • "stats": {
    }
}

put account by id

register a new account with specified id in the system

Authorizations:
path Parameters
account_id
required
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

account id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Content-Type
string
Value: "application/json"
Request Body schema: application/json
email
required
string <email> (email) <= 64 characters ^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-...

email address.

organization_name
required
string (organization_name) <= 128 characters

organization name.

Responses

Request samples

Content type
application/json
{
  • "email": "horns@hooves.com",
  • "organization_name": "Horns and Hooves"
}

Response samples

Content type
application/json
{
  • "account_id": "string"
}

remove account by id

remove the account with specified id from the system

Authorizations:
path Parameters
account_id
required
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

account id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
Example
{
  • "error_code": 12010,
  • "desc": "Bad/incomplete input data",
  • "detail": "This resource needs 'Authorization' authorization headers"
}

lists

get lists

get lists with filters

Authorizations:
query Parameters
page
integer >= 1
Default: 1
Example: page=146

a page number.

page_size
integer [ 1 .. 100 ]
Default: 10
Example: page_size=146

the number of items on page.

account_id
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: account_id=557d54ec-29ad-4f3c-93b4-c9092ef12515
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "lists": [
    ],
  • "list_count": 0
}

get list

get list info by id

Authorizations:
path Parameters
list_id
required
string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...
Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

list id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "list_id": "string",
  • "account_id": "string",
  • "last_update_time": "string",
  • "face_count": 0,
  • "user_data": "string"
}

tasks

get tasks

get tasks with filters

Authorizations:
query Parameters
page
integer >= 1
Default: 1
Example: page=146

a page number.

page_size
integer [ 1 .. 100 ]
Default: 10
Example: page_size=146

the number of items on page.

task_ids
integer (task_id) >= 1
Example: task_ids=123

comma-separated task ids

create_time__lt
string <date-time> (time)
Example: create_time__lt=2018-08-11T09:11:41.674Z

upper bound for object create_time.

create_time__gte
string <date-time> (time)
Example: create_time__gte=2018-08-11T09:10:41.674Z

lower included bound for object create_time.

end_time__lt
string <date-time> (time)
Example: end_time__lt=2018-08-11T10:11:41.674Z

upper bound for object end_time.

end_time__gte
string <date-time> (time)
Example: end_time__gte=2018-08-11T10:10:41.674Z

lower included bound for object end_time.

task_type
integer (task_type)
Enum: 0 1 2 3 4
Example: task_type=3

task type.

task type value
unknown 0
linker 1
clusterization 2
report 3
garbage collect 4
additional extract 5
task_status
integer (task_status)
Enum: 0 1 2 3 4 5
Example: task_status=1

task status.

task status value
pending 0
in progress 1
cancelled 2
failed 3
collect results 4
done 5
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "tasks": [
    ]
}

get task count

get task count

Authorizations:
query Parameters
task_ids
integer (task_id) >= 1
Example: task_ids=123

comma-separated task ids

create_time__lt
string <date-time> (time)
Example: create_time__lt=2018-08-11T09:11:41.674Z

upper bound for object create_time.

create_time__gte
string <date-time> (time)
Example: create_time__gte=2018-08-11T09:10:41.674Z

lower included bound for object create_time.

end_time__lt
string <date-time> (time)
Example: end_time__lt=2018-08-11T10:11:41.674Z

upper bound for object end_time.

end_time__gte
string <date-time> (time)
Example: end_time__gte=2018-08-11T10:10:41.674Z

lower included bound for object end_time.

task_type
integer (task_type)
Enum: 0 1 2 3 4
Example: task_type=3

task type.

task type value
unknown 0
linker 1
clusterization 2
report 3
garbage collect 4
additional extract 5
task_status
integer (task_status)
Enum: 0 1 2 3 4 5
Example: task_status=1

task status.

task status value
pending 0
in progress 1
cancelled 2
failed 3
collect results 4
done 5
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "count": 40
}

get task by id

get task by id with filters

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "task_id": 123,
  • "create_time": "string",
  • "end_time": "string",
  • "last_update_time": "string",
  • "task_type": 3,
  • "task_status": 1,
  • "result_id": "string",
  • "count_task_parts_done": 10,
  • "count_task_parts_all": 100,
  • "content": {
    },
  • "description": "string"
}

cancel task by id

cancel task by id with filters

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "error_code": 28019,
  • "desc": "Bad/incomplete input data",
  • "detail": "Task '55023' with status 5 cannot be canceled"
}

delete task by id

delete task by id

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "error_code": 28019,
  • "desc": "Bad/incomplete input data",
  • "detail": "Task '55023' with status 5 cannot be canceled"
}

get task result by id

get task result by id

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
Example
{
  • "result": [
    ],
  • "errors": {
    }
}

get task errors by task id

get task errors by task id

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

query Parameters
page
integer >= 1
Default: 1
Example: page=146

a page number.

page_size
integer [ 1 .. 100 ]
Default: 10
Example: page_size=146

the number of items on page.

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ]
}

get task error count by task id

get task error count by task id

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

query Parameters
error_time__lt
string <date-time> (time)
Example: error_time__lt=2018-08-11T09:11:41.674Z

upper bound for error time.

error_time__gte
string <date-time> (time)
Example: error_time__gte=2018-08-11T09:10:41.674Z

lower included bound for error_time.

error_code
integer (error_code)
Example: error_code=12010

error code.

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

get subtasks by task id

get subtasks by task id

Authorizations:
path Parameters
task_id
required
integer (task_id) >= 1
Example: 123

task id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

get errors

get errors

Authorizations:
query Parameters
page
integer >= 1
Default: 1
Example: page=146

a page number.

page_size
integer [ 1 .. 100 ]
Default: 10
Example: page_size=146

the number of items on page.

task_ids
integer (task_id) >= 1
Example: task_ids=123

comma-separated task ids

error_ids
string <comma-separate error ids> (error_ids) non-empty
Example: error_ids=4,5,6
error_time__lt
string <date-time> (time)
Example: error_time__lt=2018-08-11T09:11:41.674Z

upper bound for error time.

error_time__gte
string <date-time> (time)
Example: error_time__gte=2018-08-11T09:10:41.674Z

lower included bound for error_time.

task_type
integer (task_type)
Enum: 0 1 2 3 4
Example: task_type=3

task type.

task type value
unknown 0
linker 1
clusterization 2
report 3
garbage collect 4
additional extract 5
error_code
integer (error_code)
Example: error_code=12010

error code.

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ]
}

get error count

get error count

Authorizations:
query Parameters
task_ids
integer (task_id) >= 1
Example: task_ids=123

comma-separated task ids

error_ids
string <comma-separate error ids> (error_ids) non-empty
Example: error_ids=4,5,6
error_time__lt
string <date-time> (time)
Example: error_time__lt=2018-08-11T09:11:41.674Z

upper bound for error time.

error_time__gte
string <date-time> (time)
Example: error_time__gte=2018-08-11T09:10:41.674Z

lower included bound for error_time.

task_type
integer (task_type)
Enum: 0 1 2 3 4
Example: task_type=3

task type.

task type value
unknown 0
linker 1
clusterization 2
report 3
garbage collect 4
additional extract 5
error_code
integer (error_code)
Example: error_code=12010

error code.

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

get error by id

get error by id

Authorizations:
path Parameters
error_id
required
integer (error_id)

error id

header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "error_id": 0,
  • "task_id": 123,
  • "subtask_id": 5,
  • "error_code": 12010,
  • "description": "Faces not found",
  • "detail": "One or more faces not found, including face with id '8f4f0070-c464-460b-bf78-fac225df72e9'",
  • "error_time": "string",
  • "additional_info": "string"
}

create gc task

create and start gc task

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Request Body schema: application/json
description
string

provided user data for current task

required
GcEventsTaskContent (object) or GcDescriptorsTaskContent (object)

garbage collecting task content, target "events" is to remove events, target "descriptors" is to delete descriptors by version.

Responses

Request samples

Content type
application/json
{
  • "description": "gc task one",
  • "content": {
    }
}

Response samples

Content type
application/json
{
  • "task_id": 123
}

create additional extract task

create and start additional extract task

Authorizations:
header Parameters
Authorization
string
Example: Basic dGVzdHVzZXI6dGVzdHB3ZA==

base64 user:password string

Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Request Body schema: application/json
description
string

provided user data for current task.

required
any (AdditionalExtractTaskContent)

additional extract task.

Responses

Request samples

Content type
application/json
{
  • "description": "clustering usefull faces",
  • "content": {
    }
}

Response samples

Content type
application/json
{
  • "task_id": 123
}

documents

get openapi documentation

Get service OpenApi documentation. If Accept request header is of type application/x-yaml, returns documentation in yaml format or returns html documentation, if Accept-Type is text/html

Authorizations:
header Parameters
Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Accept
required
string (accept_docs_handler)
Enum: "application/x-yaml" "text/html"

acceptable type of receiving data

Responses

Response samples

Content type
application/json
{
  • "error_code": 12024,
  • "detail": "Bad/incomplete input data",
  • "desc": "Unsupported media type"
}

get development manual

Get sphinx documentation - Development Manual. After the request you will be redirected to the page /docs/dev/index.html

Authorizations:
header Parameters
Luna-Request-Id
string <timestamp,uuid> ^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...
Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

external request id. Helps to uniquely identify messages that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Responses

Response samples

Content type
application/json
{
  • "error_code": 11009,
  • "detail": "Internal server error",
  • "desc": "Internal server error"
}