Справочник 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": 134,
15    "os": "macos",
16    "webrtc_pref": "auto",
17    "canvas_pref": "real",
18    "webgl_pref": "real",
19    "ports_protection": [],
20    "screen": {
21      "width": 1440,
22      "height": 900,
23      "pixel_ratio": 2,
24      "avail_width": 1440,
25      "avail_height": 802,
26      "avail_top": 25,
27      "avail_left": 0,
28      "color_depth": 30,
29      "pixel_depth": 30
30    },
31    "fonts": [],
32    "hints": {
33      "architecture": "arm",
34      "bitness": 64,
35      "model": "",
36      "platform": "macOS",
37      "platform_version": "14.2.1",
38      "ua_full_version": "134.0.6998.166",
39      "mobile": false
40    },
41    "navigator": {
42      "hardware_concurrency": 8,
43      "device_memory": 8,
44      "max_touch_points": 0,
45      "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",
46      "platform": "MacIntel",
47      "language": "en-US",
48      "languages": [
49        "en-US",
50        "en",
51        "ar"
52      ],
53      "quota": 147064317542
54    },
55    "webgl": {
56      "unmasked_renderer": "ANGLE (Apple, ANGLE Metal Renderer: Apple M1, Unspecified Version)",
57      "unmasked_vendor": "Google Inc. (Apple)",
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_bptc",
67        "EXT_texture_compression_rgtc",
68        "EXT_texture_filter_anisotropic",
69        "EXT_sRGB",
70        "KHR_parallel_shader_compile",
71        "OES_element_index_uint",
72        "OES_fbo_render_mipmap",
73        "OES_standard_derivatives",
74        "OES_texture_float",
75        "OES_texture_float_linear",
76        "OES_texture_half_float",
77        "OES_texture_half_float_linear",
78        "OES_vertex_array_object",
79        "WEBGL_color_buffer_float",
80        "WEBGL_compressed_texture_astc",
81        "WEBGL_compressed_texture_etc",
82        "WEBGL_compressed_texture_etc1",
83        "WEBGL_compressed_texture_pvrtc",
84        "WEBGL_compressed_texture_s3tc",
85        "WEBGL_compressed_texture_s3tc_srgb",
86        "WEBGL_debug_renderer_info",
87        "WEBGL_debug_shaders",
88        "WEBGL_depth_texture",
89        "WEBGL_draw_buffers",
90        "WEBGL_lose_context",
91        "WEBGL_multi_draw"
92      ],
93      "extensions_v2": [
94        "EXT_color_buffer_float",
95        "EXT_color_buffer_half_float",
96        "EXT_disjoint_timer_query_webgl2",
97        "EXT_float_blend",
98        "EXT_texture_compression_bptc",
99        "EXT_texture_compression_rgtc",
100        "EXT_texture_filter_anisotropic",
101        "EXT_texture_norm16",
102        "KHR_parallel_shader_compile",
103        "OES_draw_buffers_indexed",
104        "OES_texture_float_linear",
105        "WEBGL_clip_cull_distance",
106        "WEBGL_compressed_texture_astc",
107        "WEBGL_compressed_texture_etc",
108        "WEBGL_compressed_texture_etc1",
109        "WEBGL_compressed_texture_pvrtc",
110        "WEBGL_compressed_texture_s3tc",
111        "WEBGL_compressed_texture_s3tc_srgb",
112        "WEBGL_debug_renderer_info",
113        "WEBGL_debug_shaders",
114        "WEBGL_lose_context",
115        "WEBGL_multi_draw",
116        "WEBGL_provoking_vertex"
117      ],
118      "extra": {
119        "uniform_buffer_offset_alignment": 16,
120        "max_elements_vertices": 2147483647,
121        "max_elements_indices": 2147483647,
122        "max_draw_buffers": 8,
123        "min_program_texel_offset": -8,
124        "max_program_texel_offset": 7,
125        "max_color_attachments": 8,
126        "max_vertex_texture_image_units": 16,
127        "max_texture_image_units": 16,
128        "max_3d_texture_size": 2048,
129        "max_texture_lod_bias": 15,
130        "max_fragment_uniform_components": 4096,
131        "max_vertex_uniform_components": 4096,
132        "max_array_texture_layers": 2048,
133        "max_varying_components": 120,
134        "max_transform_feedback_separate_components": 4,
135        "max_transform_feedback_interleaved_components": 128,
136        "max_samples": 4,
137        "max_vertex_uniform_blocks": 12,
138        "max_fragment_uniform_blocks": 12,
139        "max_combined_uniform_blocks": 24,
140        "max_uniform_buffer_bindings": 24,
141        "max_uniform_block_size": 16384,
142        "max_combined_vertex_uniform_components": 53248,
143        "max_combined_fragment_uniform_components": 53248,
144        "max_vertex_output_components": 120,
145        "max_fragment_input_components": 120,
146        "max_element_index": 4294967294,
147        "max_texture_size": 16384,
148        "max_vertex_attribs": 16,
149        "max_vertex_uniform_vectors": 1024,
150        "max_varying_vectors": 30,
151        "max_combined_texture_image_units": 32,
152        "max_fragment_uniform_vectors": 1024,
153        "max_cube_map_texture_size": 16384,
154        "max_renderbuffer_size": 16384,
155        "max_viewport_width": 16384,
156        "max_viewport_height": 16384,
157        "aliased_line_width_range_min": 1,
158        "aliased_line_width_range_max": 1,
159        "aliased_point_size_range_min": 1,
160        "aliased_point_size_range_max": 511,
161        "max_server_wait_timeout": null
162      }
163    },
164    "webgpu": {
165      "vendor": "apple",
166      "architecture": "common-3",
167      "limits": {
168        "maxBindGroups": 4,
169        "maxBufferSize": 4294967296,
170        "maxVertexBuffers": 8,
171        "maxColorAttachments": 8,
172        "maxVertexAttributes": 16,
173        "maxTextureArrayLayers": 256,
174        "maxTextureDimension1D": 8192,
175        "maxTextureDimension2D": 8192,
176        "maxTextureDimension3D": 2048,
177        "maxBindingsPerBindGroup": 1000,
178        "maxComputeWorkgroupSizeX": 1024,
179        "maxComputeWorkgroupSizeY": 1024,
180        "maxComputeWorkgroupSizeZ": 64,
181        "maxSamplersPerShaderStage": 16,
182        "maxVertexBufferArrayStride": 2048,
183        "maxUniformBufferBindingSize": 65536,
184        "maxInterStageShaderVariables": 16,
185        "maxInterStageShaderComponents": 60,
186        "maxComputeWorkgroupStorageSize": 32768,
187        "maxStorageBuffersPerShaderStage": 10,
188        "maxUniformBuffersPerShaderStage": 12,
189        "minStorageBufferOffsetAlignment": 256,
190        "minUniformBufferOffsetAlignment": 256,
191        "maxComputeWorkgroupsPerDimension": 65535,
192        "maxSampledTexturesPerShaderStage": 16,
193        "maxStorageTexturesPerShaderStage": 8,
194        "maxComputeInvocationsPerWorkgroup": 1024,
195        "maxDynamicStorageBuffersPerPipelineLayout": 8,
196        "maxDynamicUniformBuffersPerPipelineLayout": 10
197      }
198    },
199    "crc": "4c33f44e"
200  }
201}
202
203const options = {
204  method: "POST",
205  headers: {
206    "X-Token": "Your Token", 
207    "Content-Type": "application/json"
208  }, 
209  body: JSON.stringify(body)
210};
211
212fetch(url, options)
213  .then((response) => {
214    response.json().then((data) => {
215      console.log(data);
216    });
217  })
218  .catch((error) => {
219    console.error(error);
220  });

Ответ

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

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
Глубина пикселя экрана