Справочник API
Профили
Создание профиля

Базовый URL

POST
https://v1.empr.cloud/api/v1/folders/{folderId}/profiles

Запрос

Заголовки запроса

Headers
Название
Тип / Значение
Описание
X-Token
String
Токен авторизации
Content-Type
application/json

Параметры URL

Query parameters
Название
Тип / Значение
Описание
folderId
String
ID папки, в которой создаётся профиль

Тело запроса

Для создания профиля необходим отпечаток, посмотрите Получение отпечатка

Body
Название
Тип / Значение
Описание
profile_name
String
Название профиля
profile_notes
String
Заметки профиля
profile_tags
Array
Массив с тегами профиля
proxy_id
String
ID прокси, которая будет назначена на профиль
profile_status
Array
Массив статуса профиля в формате ['name', 'color']
platform
String
ОС профиля. Доступные значения: Windows, Mac, Linux
browser
String
Ядро браузера для профиля. Доступные значения: Chrome
fingerprint
Object
Объект с отпечатком профиля

Обязательные параметры объекта fingerprint

fingerprint
Название
Тип / Значение
Описание
webrtc_pref
String/Object
Режим работы WebRTC. Доступные значения: auto, off или manual. При выборе manual требуется передавать объект вида: {manual: '127.0.0.1'}
webgl_pref
String/Object
Режим работы WebGL. Доступные значения: real, off или noise. При выборе noise требуется передавать объект вида: {noise: 1.36065635}. Значением ключа noise должно быть типа float с 8-ю знаками после точки
canvas_pref
String/Object
Режим работы Canvas. Доступные значения: real, off или noise. При выборе noise требуется передавать объект вида: {noise: 1.36065612}. Значением ключа noise должно быть типа float с 8-ю знаками после точки
ports_protection
Array
Массив со значениями портов типа Number

Дополнительные параметры объекта fingerprint

fingerprint
Название
Тип / Значение
Описание
audio_input
Number
Количество устройств аудио-ввода
audio_output
Number
Количество устройств аудио-вывода
video_input
Number
Количество устройств видео-ввода

Примеры запроса

1const url =
2  "https://v1.empr.cloud/api/v1/folders/{folderId}/profiles"; 
3
4const body = {
5  "profile_name": "Тестовый профиль",
6  "profile_notes": "",
7  "profile_tags": [],
8  "proxy_id": null,
9  "new_profile_tags": [],
10  "profile_status": null,
11  "browser": "Chrome",
12  "platform": "MacOS",
13  "fingerprint": {
14    "major": 120,
15    "os": "macos",
16    "webrtc_pref": "auto",
17    "canvas_pref": "real",
18    "webgl_pref": "real",
19    "client_rects": null,
20    "ports_protection": [],
21    "geolocation": null,
22    "media_devices": null,
23    "screen": {
24      "width": 1440,
25      "height": 900,
26      "pixel_ratio": 1,
27      "avail_width": 1440,
28      "avail_height": 825,
29      "avail_top": 25,
30      "avail_left": 0,
31      "color_depth": 24,
32      "pixel_depth": 24
33    },
34    "fonts": [],
35    "hints": {
36      "architecture": "x86",
37      "bitness": 64,
38      "model": "",
39      "platform": "macOS",
40      "platform_version": "11.7.10",
41      "ua_full_version": "120.0.6099.62",
42      "mobile": false
43    },
44    "navigator": {
45      "hardware_concurrency": 4,
46      "device_memory": 8,
47      "max_touch_points": 1,
48      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
49      "platform": "macos",
50      "timezone": null,
51      "language": "auto",
52      "languages": [],
53      "quota": 72673841970
54    },
55    "webgl": {
56      "unmasked_renderer": "ANGLE (Intel Inc., Intel(R) HD Graphics 6000, OpenGL 4.1)",
57      "unmasked_vendor": "Google Inc. (Intel Inc.)",
58      "extensions": [
59        "ANGLE_instanced_arrays",
60        "EXT_blend_minmax",
61        "EXT_color_buffer_half_float",
62        "EXT_disjoint_timer_query",
63        "EXT_float_blend",
64        "EXT_frag_depth",
65        "EXT_shader_texture_lod",
66        "EXT_texture_compression_rgtc",
67        "EXT_texture_filter_anisotropic",
68        "EXT_sRGB",
69        "OES_element_index_uint",
70        "OES_fbo_render_mipmap",
71        "OES_standard_derivatives",
72        "OES_texture_float",
73        "OES_texture_float_linear",
74        "OES_texture_half_float",
75        "OES_texture_half_float_linear",
76        "OES_vertex_array_object",
77        "WEBGL_color_buffer_float",
78        "WEBGL_compressed_texture_s3tc",
79        "WEBGL_compressed_texture_s3tc_srgb",
80        "WEBGL_debug_renderer_info",
81        "WEBGL_debug_shaders",
82        "WEBGL_depth_texture",
83        "WEBGL_draw_buffers",
84        "WEBGL_lose_context",
85        "WEBGL_multi_draw"
86      ],
87      "extra": {
88        "uniform_buffer_offset_alignment": 256,
89        "max_elements_vertices": 1048575,
90        "max_elements_indices": 150000,
91        "max_draw_buffers": 8,
92        "min_program_texel_offset": -8,
93        "max_program_texel_offset": 7,
94        "max_color_attachments": 8,
95        "max_vertex_texture_image_units": 16,
96        "max_texture_image_units": 16,
97        "max_3d_texture_size": 2048,
98        "max_texture_lod_bias": 16,
99        "max_fragment_uniform_components": 4096,
100        "max_vertex_uniform_components": 4096,
101        "max_array_texture_layers": 2048,
102        "max_varying_components": 60,
103        "max_transform_feedback_separate_components": 4,
104        "max_transform_feedback_interleaved_components": 64,
105        "max_samples": 4,
106        "max_vertex_uniform_blocks": 15,
107        "max_fragment_uniform_blocks": 15,
108        "max_combined_uniform_blocks": 30,
109        "max_uniform_buffer_bindings": 72,
110        "max_uniform_block_size": 65536,
111        "max_combined_vertex_uniform_components": 249856,
112        "max_combined_fragment_uniform_components": 249856,
113        "max_vertex_output_components": 128,
114        "max_fragment_input_components": 128,
115        "max_element_index": 4294967295,
116        "max_texture_size": 16384,
117        "max_vertex_attribs": 16,
118        "max_vertex_uniform_vectors": 1024,
119        "max_varying_vectors": 15,
120        "max_combined_texture_image_units": 32,
121        "max_fragment_uniform_vectors": 1024,
122        "max_cube_map_texture_size": 16384,
123        "max_renderbuffer_size": 16384,
124        "max_viewport_width": 16384,
125        "max_viewport_height": 16384,
126        "aliased_line_width_range_min": 1,
127        "aliased_line_width_range_max": 1,
128        "aliased_point_size_range_min": 1,
129        "aliased_point_size_range_max": 255.875,
130        "max_server_wait_timeout": 0
131      }
132    },
133    "webgpu": {
134      "vendor": "intel",
135      "architecture": "gen-8",
136      "limits": {
137        "maxBindGroups": 4,
138        "maxBufferSize": 2147483648,
139        "maxVertexBuffers": 8,
140        "maxColorAttachments": 8,
141        "maxVertexAttributes": 16,
142        "maxTextureArrayLayers": 256,
143        "maxTextureDimension1D": 8192,
144        "maxTextureDimension2D": 8192,
145        "maxTextureDimension3D": 2048,
146        "maxBindingsPerBindGroup": 1000,
147        "maxComputeWorkgroupSizeX": 1024,
148        "maxComputeWorkgroupSizeY": 1024,
149        "maxComputeWorkgroupSizeZ": 64,
150        "maxSamplersPerShaderStage": 16,
151        "maxVertexBufferArrayStride": 2048,
152        "maxUniformBufferBindingSize": 65536,
153        "maxInterStageShaderVariables": 16,
154        "maxInterStageShaderComponents": 60,
155        "maxComputeWorkgroupStorageSize": 32768,
156        "maxStorageBuffersPerShaderStage": 8,
157        "maxUniformBuffersPerShaderStage": 12,
158        "minStorageBufferOffsetAlignment": 256,
159        "minUniformBufferOffsetAlignment": 256,
160        "maxComputeWorkgroupsPerDimension": 65535,
161        "maxSampledTexturesPerShaderStage": 16,
162        "maxStorageTexturesPerShaderStage": 8,
163        "maxComputeInvocationsPerWorkgroup": 1024,
164        "maxDynamicStorageBuffersPerPipelineLayout": 8,
165        "maxDynamicUniformBuffersPerPipelineLayout": 10
166      }
167    },
168    "crc": "7048a23e"
169  }
170}
171
172const options = {
173  method: "POST",
174  headers: {
175    "X-Token": "Your Token", 
176    "Content-Type": "application/json"
177  }, 
178  body: JSON.stringify(body)
179};
180
181fetch(url, options)
182  .then((response) => {
183    response.json().then((data) => {
184      console.log(data);
185    });
186  })
187  .catch((error) => {
188    console.error(error);
189  });

Ответ

Данные ответа

Response
Название
Тип / Значение
Описание
data
Object
Объект со всеми данными созданного профиля
usage
Object
Объект с данными по использованию тарифа

Пример ответа

1{
2    "data": {
3        "owner": "***privacy***",
4        "id": "***privacy***",
5        "folder_id": "***privacy***",
6        "proxy_id": null,
7        "profile_name": "Test profile",
8        "profile_notes": "",
9        "profile_status": null,
10        "profile_tags": [],
11        "browser": "chrome",
12        "platform": "macos",
13        "fingerprint": {
14            "major": 120,
15            "os": "macos",
16            "screen": {
17                "width": 1440,
18                "height": 900,
19                "pixel_ratio": 1.0,
20                "avail_width": 1440,
21                "avail_height": 825,
22                "avail_top": 25,
23                "avail_left": 0,
24                "color_depth": 24,
25                "pixel_depth": 24
26            },
27            "fonts": [],
28            "webrtc_pref": "auto",
29            "canvas_pref": "real",
30            "webgl_pref": "real",
31            "media_devices": null,
32            "ports_protection": [],
33            "geolocation": null,
34            "client_rects": null,
35            "hints": {
36                "architecture": "x86",
37                "bitness": 64,
38                "model": "",
39                "platform": "macOS",
40                "platform_version": "11.7.10",
41                "mobile": false,
42                "ua_full_version": "120.0.6099.62"
43            },
44            "navigator": {
45                "hardware_concurrency": 4,
46                "device_memory": 8.0,
47                "max_touch_points": 1,
48                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
49                "platform": "macos",
50                "timezone": null,
51                "language": "auto",
52                "languages": [],
53                "quota": 72673841970
54            },
55            "webgl": {
56                "unmasked_renderer": "ANGLE (Intel Inc., Intel(R) HD Graphics 6000, OpenGL 4.1)",
57                "unmasked_vendor": "Google Inc. (Intel Inc.)",
58                "extensions": [
59                    "ANGLE_instanced_arrays",
60                    "EXT_blend_minmax",
61                    "EXT_color_buffer_half_float",
62                    "EXT_disjoint_timer_query",
63                    "EXT_float_blend",
64                    "EXT_frag_depth",
65                    "EXT_shader_texture_lod",
66                    "EXT_texture_compression_rgtc",
67                    "EXT_texture_filter_anisotropic",
68                    "EXT_sRGB",
69                    "OES_element_index_uint",
70                    "OES_fbo_render_mipmap",
71                    "OES_standard_derivatives",
72                    "OES_texture_float",
73                    "OES_texture_float_linear",
74                    "OES_texture_half_float",
75                    "OES_texture_half_float_linear",
76                    "OES_vertex_array_object",
77                    "WEBGL_color_buffer_float",
78                    "WEBGL_compressed_texture_s3tc",
79                    "WEBGL_compressed_texture_s3tc_srgb",
80                    "WEBGL_debug_renderer_info",
81                    "WEBGL_debug_shaders",
82                    "WEBGL_depth_texture",
83                    "WEBGL_draw_buffers",
84                    "WEBGL_lose_context",
85                    "WEBGL_multi_draw"
86                ],
87                "extensions_v2": null,
88                "extra": {
89                    "uniform_buffer_offset_alignment": 256,
90                    "max_elements_vertices": 1048575,
91                    "max_elements_indices": 150000,
92                    "max_draw_buffers": 8,
93                    "min_program_texel_offset": -8,
94                    "max_program_texel_offset": 7,
95                    "max_color_attachments": 8,
96                    "max_vertex_texture_image_units": 16,
97                    "max_texture_image_units": 16,
98                    "max_3d_texture_size": 2048,
99                    "max_texture_lod_bias": 16,
100                    "max_fragment_uniform_components": 4096,
101                    "max_vertex_uniform_components": 4096,
102                    "max_array_texture_layers": 2048,
103                    "max_varying_components": 60,
104                    "max_transform_feedback_separate_components": 4,
105                    "max_transform_feedback_interleaved_components": 64,
106                    "max_samples": 4,
107                    "max_vertex_uniform_blocks": 15,
108                    "max_fragment_uniform_blocks": 15,
109                    "max_combined_uniform_blocks": 30,
110                    "max_uniform_buffer_bindings": 72,
111                    "max_uniform_block_size": 65536,
112                    "max_combined_vertex_uniform_components": 249856,
113                    "max_combined_fragment_uniform_components": 249856,
114                    "max_vertex_output_components": 128,
115                    "max_fragment_input_components": 128,
116                    "max_element_index": 4294967295.0,
117                    "max_texture_size": 16384,
118                    "max_vertex_attribs": 16,
119                    "max_vertex_uniform_vectors": 1024,
120                    "max_varying_vectors": 15,
121                    "max_combined_texture_image_units": 32,
122                    "max_fragment_uniform_vectors": 1024,
123                    "max_cube_map_texture_size": 16384,
124                    "max_renderbuffer_size": 16384,
125                    "max_viewport_width": 16384,
126                    "max_viewport_height": 16384,
127                    "aliased_line_width_range_min": 1.0,
128                    "aliased_line_width_range_max": 1.0,
129                    "aliased_point_size_range_min": 1.0,
130                    "aliased_point_size_range_max": 255.875,
131                    "max_server_wait_timeout": 0
132                }
133            },
134            "webgpu": {
135                "vendor": "intel",
136                "architecture": "gen-8",
137                "limits": {
138                    "maxBindGroups": 4,
139                    "maxBufferSize": 2147483648.0,
140                    "maxVertexBuffers": 8,
141                    "maxColorAttachments": 8,
142                    "maxVertexAttributes": 16,
143                    "maxTextureArrayLayers": 256,
144                    "maxTextureDimension1D": 8192,
145                    "maxTextureDimension2D": 8192,
146                    "maxTextureDimension3D": 2048,
147                    "maxBindingsPerBindGroup": 1000,
148                    "maxComputeWorkgroupSizeX": 1024,
149                    "maxComputeWorkgroupSizeY": 1024,
150                    "maxComputeWorkgroupSizeZ": 64,
151                    "maxSamplersPerShaderStage": 16,
152                    "maxVertexBufferArrayStride": 2048,
153                    "maxUniformBufferBindingSize": 65536,
154                    "maxInterStageShaderVariables": 16,
155                    "maxInterStageShaderComponents": 60,
156                    "maxComputeWorkgroupStorageSize": 32768,
157                    "maxStorageBuffersPerShaderStage": 8,
158                    "maxUniformBuffersPerShaderStage": 12,
159                    "minStorageBufferOffsetAlignment": 256,
160                    "minUniformBufferOffsetAlignment": 256,
161                    "maxComputeWorkgroupsPerDimension": 65535,
162                    "maxSampledTexturesPerShaderStage": 16,
163                    "maxStorageTexturesPerShaderStage": 8,
164                    "maxComputeInvocationsPerWorkgroup": 1024,
165                    "maxDynamicStorageBuffersPerPipelineLayout": 8,
166                    "maxDynamicUniformBuffersPerPipelineLayout": 10
167                }
168            },
169            "crc": "7048a23e"
170        },
171        "running": false,
172        "pinned": false,
173        "worktime": 0,
174        "last_run_at": null,
175        "created_at": "2024-01-06T15:59:36.070341Z",
176        "updated_at": "2024-01-06T15:59:36.070341Z",
177        "recovered": 0,
178        "is_received": false,
179        "app_version": "0.0.0",
180        "proxy": null
181    },
182    "usage": {
183        "users": 1,
184        "profiles": 1
185    }
186}

Типы

Profile
Название
Тип / Значение
Описание
owner
String
Владелец профиля
id
String
Идентификатор профиля
folder_id
String
Идентификатор папки
proxy_id
UUID | null
Идентификатор прокси (null, если отсутствует)
profile_name
String
Название профиля
profile_notes
String
Заметки для профиля
profile_status
UUID | null
Статус профиля (null, если не применимо)
profile_tags
UUID[]
Массив UUID, представляющий теги, связанные с профилем
browser
String
Браузер, используемый профилем
platform
String
Платформа, используемая профилем (macos/windows/linux)
fingerprint
Fingerprint
Отпечаток, используемый профилем
running
Boolean
Является ли профиль в настоящее время активным
pinned
Boolean
Является ли профиль в настоящее время закрепленным
worktime
Number
Время работы профиля в секундах
last_run_at
Timestamp?
Время последнего запуска профиля
created_at
Timestamp
Время создания профиля
updated_at
Timestamp
Время последнего обновления профиля
proxy
Proxy | null
Прокси, используемый профилем
Fingerprint
Название
Тип / Значение
Описание
major
Number
Основная версия отпечатка
os
String
Операционная система отпечатка
screen
Screen
Детали экрана отпечатка
fonts
String[]
Массив установленных шрифтов в системе
webrtc_pref
String
Настройки WebRTC
canvas_pref
String
Настройки Canvas
webgl_pref
String
Настройки WebGL
media_devices
null
Информация о мультимедийных устройствах
ports_protection
string[]
Массив защищенных портов
geolocation
null
Настройки геолокации
client_rects
null
Настройки клиентских прямоугольников
hints
...
Подсказки о устройстве
navigator
...
Информация о навигаторе
webgl
...
Информация о WebGL
webgpu
...
Информация о WebGPU
crc
String
Значение CRC
Screen
Название
Тип / Значение
Описание
width
Number
Ширина экрана
height
Number
Высота экрана
pixel_ratio
Number
Пиксельное соотношение экрана
avail_width
Number
Доступная ширина экрана
avail_height
Number
Доступная высота экрана
avail_top
Number
Доступная верхняя позиция экрана
avail_left
Number
Доступная левая позиция экрана
color_depth
Number
Глубина цвета экрана
pixel_depth
Number
Глубина пикселя экрана