Базовый 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, MacOS, 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
Количество устройств видео-ввода
Режим работы Audio
fingerprint
Название
Тип / Значение
Описание
audio_pref
Null | Number
Режим работы Audio. Для использования audio в режиме Шум необходимо передать число с 8 знаками после точки, например 1.23456789. Для использования audio в режиме Реальный необходимо передать null или не указывать параметр audio_pref в объекте fingerprint
Режим работы Client Rects
fingerprint
Название
Тип / Значение
Описание
client_rects
Null | Number
Режим работы Client Rects. Доступные значения: real или noise. При выборе Real требуется передать client_rects: null. При выборе noise требуется передавать client_rects: 1.007612. Значение ключа client_rects должно быть типа float с 6-ю знаками после точки
Примеры запроса
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": 144,
15 "os": "macos",
16 "webrtc_pref": "auto",
17 "canvas_pref": "real",
18 "webgl_pref": "real",
19 "ports_protection": [],
20 "audio_pref": null,
21 "screen": {
22 "width": 1440,
23 "height": 900,
24 "pixel_ratio": 2,
25 "avail_width": 1440,
26 "avail_height": 790,
27 "avail_top": 25,
28 "avail_left": 0,
29 "color_depth": 30,
30 "pixel_depth": 30
31 },
32 "fonts": [],
33 "hints": {
34 "architecture": "arm",
35 "bitness": 64,
36 "model": "",
37 "platform": "macOS",
38 "platform_version": "15.5.0",
39 "ua_full_version": "144.0.7559.97",
40 "mobile": false
41 },
42 "navigator": {
43 "hardware_concurrency": 8,
44 "device_memory": 8,
45 "max_touch_points": 0,
46 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36",
47 "platform": "MacIntel",
48 "language": "de-DE",
49 "languages": [
50 "de-DE"
51 ],
52 "quota": 147064317542
53 },
54 "webgl": {
55 "unmasked_renderer": "ANGLE (Apple, ANGLE Metal Renderer: Apple M1, Unspecified Version)",
56 "unmasked_vendor": "Google Inc. (Apple)",
57 "extensions": [
58 "ANGLE_instanced_arrays",
59 "EXT_blend_minmax",
60 "EXT_clip_control",
61 "EXT_color_buffer_half_float",
62 "EXT_depth_clamp",
63 "EXT_disjoint_timer_query",
64 "EXT_float_blend",
65 "EXT_frag_depth",
66 "EXT_polygon_offset_clamp",
67 "EXT_shader_texture_lod",
68 "EXT_texture_compression_bptc",
69 "EXT_texture_compression_rgtc",
70 "EXT_texture_filter_anisotropic",
71 "EXT_texture_mirror_clamp_to_edge",
72 "EXT_sRGB",
73 "KHR_parallel_shader_compile",
74 "OES_element_index_uint",
75 "OES_fbo_render_mipmap",
76 "OES_standard_derivatives",
77 "OES_texture_float",
78 "OES_texture_float_linear",
79 "OES_texture_half_float",
80 "OES_texture_half_float_linear",
81 "OES_vertex_array_object",
82 "WEBGL_blend_func_extended",
83 "WEBGL_color_buffer_float",
84 "WEBGL_compressed_texture_astc",
85 "WEBGL_compressed_texture_etc",
86 "WEBGL_compressed_texture_etc1",
87 "WEBGL_compressed_texture_pvrtc",
88 "WEBGL_compressed_texture_s3tc",
89 "WEBGL_compressed_texture_s3tc_srgb",
90 "WEBGL_debug_renderer_info",
91 "WEBGL_debug_shaders",
92 "WEBGL_depth_texture",
93 "WEBGL_draw_buffers",
94 "WEBGL_lose_context",
95 "WEBGL_multi_draw",
96 "WEBGL_polygon_mode"
97 ],
98 "extensions_v2": [
99 "EXT_clip_control",
100 "EXT_color_buffer_float",
101 "EXT_color_buffer_half_float",
102 "EXT_conservative_depth",
103 "EXT_depth_clamp",
104 "EXT_disjoint_timer_query_webgl2",
105 "EXT_float_blend",
106 "EXT_polygon_offset_clamp",
107 "EXT_render_snorm",
108 "EXT_texture_compression_bptc",
109 "EXT_texture_compression_rgtc",
110 "EXT_texture_filter_anisotropic",
111 "EXT_texture_mirror_clamp_to_edge",
112 "EXT_texture_norm16",
113 "KHR_parallel_shader_compile",
114 "NV_shader_noperspective_interpolation",
115 "OES_draw_buffers_indexed",
116 "OES_sample_variables",
117 "OES_shader_multisample_interpolation",
118 "OES_texture_float_linear",
119 "WEBGL_blend_func_extended",
120 "WEBGL_clip_cull_distance",
121 "WEBGL_compressed_texture_astc",
122 "WEBGL_compressed_texture_etc",
123 "WEBGL_compressed_texture_etc1",
124 "WEBGL_compressed_texture_pvrtc",
125 "WEBGL_compressed_texture_s3tc",
126 "WEBGL_compressed_texture_s3tc_srgb",
127 "WEBGL_debug_renderer_info",
128 "WEBGL_debug_shaders",
129 "WEBGL_lose_context",
130 "WEBGL_multi_draw",
131 "WEBGL_polygon_mode",
132 "WEBGL_provoking_vertex",
133 "WEBGL_render_shared_exponent",
134 "WEBGL_stencil_texturing"
135 ],
136 "extra": {
137 "uniform_buffer_offset_alignment": 16,
138 "max_elements_vertices": 2147483647,
139 "max_elements_indices": 2147483647,
140 "max_draw_buffers": 8,
141 "min_program_texel_offset": -8,
142 "max_program_texel_offset": 7,
143 "max_color_attachments": 8,
144 "max_vertex_texture_image_units": 16,
145 "max_texture_image_units": 16,
146 "max_3d_texture_size": 2048,
147 "max_texture_lod_bias": 15,
148 "max_fragment_uniform_components": 4096,
149 "max_vertex_uniform_components": 4096,
150 "max_array_texture_layers": 2048,
151 "max_varying_components": 120,
152 "max_transform_feedback_separate_components": 4,
153 "max_transform_feedback_interleaved_components": 128,
154 "max_samples": 4,
155 "max_vertex_uniform_blocks": 12,
156 "max_fragment_uniform_blocks": 12,
157 "max_combined_uniform_blocks": 24,
158 "max_uniform_buffer_bindings": 24,
159 "max_uniform_block_size": 16384,
160 "max_combined_vertex_uniform_components": 53248,
161 "max_combined_fragment_uniform_components": 53248,
162 "max_vertex_output_components": 120,
163 "max_fragment_input_components": 120,
164 "max_element_index": 4294967294,
165 "max_texture_size": 16384,
166 "max_vertex_attribs": 16,
167 "max_vertex_uniform_vectors": 1024,
168 "max_varying_vectors": 30,
169 "max_combined_texture_image_units": 32,
170 "max_fragment_uniform_vectors": 1024,
171 "max_cube_map_texture_size": 16384,
172 "max_renderbuffer_size": 16384,
173 "max_viewport_width": 16384,
174 "max_viewport_height": 16384,
175 "aliased_line_width_range_min": 1,
176 "aliased_line_width_range_max": 1,
177 "aliased_point_size_range_min": 1,
178 "aliased_point_size_range_max": 511,
179 "max_server_wait_timeout": null
180 }
181 },
182 "webgpu": {
183 "vendor": "apple",
184 "architecture": "metal-3",
185 "limits": {
186 "maxBindGroups": 4,
187 "maxBufferSize": 4294967296,
188 "maxVertexBuffers": 8,
189 "maxColorAttachments": 8,
190 "maxVertexAttributes": 30,
191 "maxTextureArrayLayers": 2048,
192 "maxTextureDimension1D": 16384,
193 "maxTextureDimension2D": 16384,
194 "maxTextureDimension3D": 2048,
195 "maxBindingsPerBindGroup": 1000,
196 "maxComputeWorkgroupSizeX": 1024,
197 "maxComputeWorkgroupSizeY": 1024,
198 "maxComputeWorkgroupSizeZ": 64,
199 "maxSamplersPerShaderStage": 16,
200 "maxVertexBufferArrayStride": 2048,
201 "maxUniformBufferBindingSize": 65536,
202 "maxInterStageShaderVariables": 28,
203 "maxInterStageShaderComponents": 0,
204 "maxComputeWorkgroupStorageSize": 32768,
205 "maxStorageBuffersPerShaderStage": 10,
206 "maxUniformBuffersPerShaderStage": 12,
207 "minStorageBufferOffsetAlignment": 256,
208 "minUniformBufferOffsetAlignment": 256,
209 "maxComputeWorkgroupsPerDimension": 65535,
210 "maxSampledTexturesPerShaderStage": 16,
211 "maxStorageTexturesPerShaderStage": 8,
212 "maxComputeInvocationsPerWorkgroup": 1024,
213 "maxDynamicStorageBuffersPerPipelineLayout": 8,
214 "maxDynamicUniformBuffersPerPipelineLayout": 10
215 }
216 },
217 "crc": "ab2dc8de"
218 }
219}
220
221const options = {
222 method: "POST",
223 headers: {
224 "X-Token": "Your Token",
225 "Content-Type": "application/json"
226 },
227 body: JSON.stringify(body)
228};
229
230fetch(url, options)
231 .then((response) => {
232 response.json().then((data) => {
233 console.log(data);
234 });
235 })
236 .catch((error) => {
237 console.error(error);
238 });Ответ
Данные ответа
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": "Тестовый профиль",
8 "profile_notes": "",
9 "profile_status": null,
10 "profile_tags": [],
11 "browser": "chrome",
12 "platform": "macos",
13 "fingerprint": {
14 "major": 134,
15 "os": "macos",
16 "screen": {
17 "width": 1440,
18 "height": 900,
19 "pixel_ratio": 2.0,
20 "avail_width": 1440,
21 "avail_height": 802,
22 "avail_top": 25,
23 "avail_left": 0,
24 "color_depth": 30,
25 "pixel_depth": 30
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": "arm",
37 "bitness": 64,
38 "model": "",
39 "platform": "macOS",
40 "platform_version": "14.2.1",
41 "mobile": false,
42 "ua_full_version": "134.0.6998.166"
43 },
44 "navigator": {
45 "hardware_concurrency": 8,
46 "device_memory": 8.0,
47 "max_touch_points": 0,
48 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
49 "platform": "MacIntel",
50 "timezone": null,
51 "language": "en-US",
52 "languages": [
53 "en-US",
54 "en",
55 "ar"
56 ],
57 "quota": 147064317542,
58 "dnt": null
59 },
60 "webgl": {
61 "unmasked_renderer": "ANGLE (Apple, ANGLE Metal Renderer: Apple M1, Unspecified Version)",
62 "unmasked_vendor": "Google Inc. (Apple)",
63 "extensions": [
64 "ANGLE_instanced_arrays",
65 "EXT_blend_minmax",
66 "EXT_color_buffer_half_float",
67 "EXT_disjoint_timer_query",
68 "EXT_float_blend",
69 "EXT_frag_depth",
70 "EXT_shader_texture_lod",
71 "EXT_texture_compression_bptc",
72 "EXT_texture_compression_rgtc",
73 "EXT_texture_filter_anisotropic",
74 "EXT_sRGB",
75 "KHR_parallel_shader_compile",
76 "OES_element_index_uint",
77 "OES_fbo_render_mipmap",
78 "OES_standard_derivatives",
79 "OES_texture_float",
80 "OES_texture_float_linear",
81 "OES_texture_half_float",
82 "OES_texture_half_float_linear",
83 "OES_vertex_array_object",
84 "WEBGL_color_buffer_float",
85 "WEBGL_compressed_texture_astc",
86 "WEBGL_compressed_texture_etc",
87 "WEBGL_compressed_texture_etc1",
88 "WEBGL_compressed_texture_pvrtc",
89 "WEBGL_compressed_texture_s3tc",
90 "WEBGL_compressed_texture_s3tc_srgb",
91 "WEBGL_debug_renderer_info",
92 "WEBGL_debug_shaders",
93 "WEBGL_depth_texture",
94 "WEBGL_draw_buffers",
95 "WEBGL_lose_context",
96 "WEBGL_multi_draw"
97 ],
98 "extensions_v2": [
99 "EXT_color_buffer_float",
100 "EXT_color_buffer_half_float",
101 "EXT_disjoint_timer_query_webgl2",
102 "EXT_float_blend",
103 "EXT_texture_compression_bptc",
104 "EXT_texture_compression_rgtc",
105 "EXT_texture_filter_anisotropic",
106 "EXT_texture_norm16",
107 "KHR_parallel_shader_compile",
108 "OES_draw_buffers_indexed",
109 "OES_texture_float_linear",
110 "WEBGL_clip_cull_distance",
111 "WEBGL_compressed_texture_astc",
112 "WEBGL_compressed_texture_etc",
113 "WEBGL_compressed_texture_etc1",
114 "WEBGL_compressed_texture_pvrtc",
115 "WEBGL_compressed_texture_s3tc",
116 "WEBGL_compressed_texture_s3tc_srgb",
117 "WEBGL_debug_renderer_info",
118 "WEBGL_debug_shaders",
119 "WEBGL_lose_context",
120 "WEBGL_multi_draw",
121 "WEBGL_provoking_vertex"
122 ],
123 "extra": {
124 "uniform_buffer_offset_alignment": 16,
125 "max_elements_vertices": 2147483647,
126 "max_elements_indices": 2147483647,
127 "max_draw_buffers": 8,
128 "min_program_texel_offset": -8,
129 "max_program_texel_offset": 7,
130 "max_color_attachments": 8,
131 "max_vertex_texture_image_units": 16,
132 "max_texture_image_units": 16,
133 "max_3d_texture_size": 2048,
134 "max_texture_lod_bias": 15,
135 "max_fragment_uniform_components": 4096,
136 "max_vertex_uniform_components": 4096,
137 "max_array_texture_layers": 2048,
138 "max_varying_components": 120,
139 "max_transform_feedback_separate_components": 4,
140 "max_transform_feedback_interleaved_components": 128,
141 "max_samples": 4,
142 "max_vertex_uniform_blocks": 12,
143 "max_fragment_uniform_blocks": 12,
144 "max_combined_uniform_blocks": 24,
145 "max_uniform_buffer_bindings": 24,
146 "max_uniform_block_size": 16384,
147 "max_combined_vertex_uniform_components": 53248,
148 "max_combined_fragment_uniform_components": 53248,
149 "max_vertex_output_components": 120,
150 "max_fragment_input_components": 120,
151 "max_element_index": 4294967294.0,
152 "max_texture_size": 16384,
153 "max_vertex_attribs": 16,
154 "max_vertex_uniform_vectors": 1024,
155 "max_varying_vectors": 30,
156 "max_combined_texture_image_units": 32,
157 "max_fragment_uniform_vectors": 1024,
158 "max_cube_map_texture_size": 16384,
159 "max_renderbuffer_size": 16384,
160 "max_viewport_width": 16384,
161 "max_viewport_height": 16384,
162 "aliased_line_width_range_min": 1.0,
163 "aliased_line_width_range_max": 1.0,
164 "aliased_point_size_range_min": 1.0,
165 "aliased_point_size_range_max": 511.0,
166 "max_server_wait_timeout": null
167 }
168 },
169 "webgpu": {
170 "vendor": "apple",
171 "architecture": "common-3",
172 "limits": {
173 "maxBindGroups": 4,
174 "maxBufferSize": 4294967296.0,
175 "maxVertexBuffers": 8,
176 "maxColorAttachments": 8,
177 "maxVertexAttributes": 16,
178 "maxTextureArrayLayers": 256,
179 "maxTextureDimension1D": 8192,
180 "maxTextureDimension2D": 8192,
181 "maxTextureDimension3D": 2048,
182 "maxBindingsPerBindGroup": 1000,
183 "maxComputeWorkgroupSizeX": 1024,
184 "maxComputeWorkgroupSizeY": 1024,
185 "maxComputeWorkgroupSizeZ": 64,
186 "maxSamplersPerShaderStage": 16,
187 "maxVertexBufferArrayStride": 2048,
188 "maxUniformBufferBindingSize": 65536,
189 "maxInterStageShaderVariables": 16,
190 "maxInterStageShaderComponents": 60,
191 "maxComputeWorkgroupStorageSize": 32768,
192 "maxStorageBuffersPerShaderStage": 10,
193 "maxUniformBuffersPerShaderStage": 12,
194 "minStorageBufferOffsetAlignment": 256,
195 "minUniformBufferOffsetAlignment": 256,
196 "maxComputeWorkgroupsPerDimension": 65535,
197 "maxSampledTexturesPerShaderStage": 16,
198 "maxStorageTexturesPerShaderStage": 8,
199 "maxComputeInvocationsPerWorkgroup": 1024,
200 "maxDynamicStorageBuffersPerPipelineLayout": 8,
201 "maxDynamicUniformBuffersPerPipelineLayout": 10
202 }
203 },
204 "crc": "4c33f44e"
205 },
206 "running": false,
207 "pinned": false,
208 "worktime": 0,
209 "last_run_at": null,
210 "created_at": "2025-04-02T12:04:47.613107Z",
211 "updated_at": "2025-04-02T12:04:47.613107Z",
212 "recovered": 0,
213 "is_received": false,
214 "app_version": "0.0.0",
215 "proxy": null
216 },
217 "usage": {
218 "users": 1,
219 "profiles": 1
220 }
221}Типы
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
Глубина пикселя экрана