# Profiles

创建、修改、查询和删除浏览器配置。

 - [POST /env/create/quick](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/quickcreatebrowserprofileopenapi.md): 批量创建 1 到 200 个配置相同的浏览器。 - **前置条件**：团队套餐必须有足够的剩余浏览器额度，且当日创建配额未用尽。`isEncrypt=1` 要求团队已配置加密密钥。Firefox 仅在 Windows 与 macOS 上可用。`groupId` 必须已存在，但改传 `groupName` 会自动创建分组。 - **副作用**：写入浏览器，消耗套餐额度并递增当日创建计数。传入代理连接
 - [POST /env/create/advanced](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/advancedcreatebrowserprofileopenapi.md): 创建一个浏览器，并指定完整的指纹配置。 - **前置条件**：与快速创建相同的套餐额度与当日配额校验。浏览器名称在团队内必须唯一，坐标必须落在中国大陆以外，且 `advancedSetting.ua` 必须与 `uaVersion` 一致。传入的 `proxyId` 必须已存在于团队中。 - **副作用**：写入浏览器、其账号凭据（加密存储）和启动后配置；消耗套餐额度与当日创建计数。自定义平台 U
 - [POST /env/update](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/updatebrowserprofileopenapi.md): 更新已有的浏览器。只修改请求中出现的字段。 - **前置条件**：浏览器必须存在于团队中。端到端加密的浏览器不可更新。操作系统与浏览器类型不可更改。运行中的浏览器可以更新。 - **副作用**：写入浏览器主记录、其扩展设置与 Cookie，并合并高级指纹设置（未被覆盖的已有值保留）。 - **完成信号**：同步。 - **重试**：相同请求体可安全重复。注意没有乐观锁：对同一浏览器的并发更新是后写
 - [POST /env/page](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/listbrowserprofilesopenapi.md): 分页列出当前认证成员可见的浏览器。 - **副作用**：无。只读。可带退避安全重试。 - **筛选**：`keyword` 匹配浏览器名称、备注、标签名与分组名。`groupId` 为 `0` 表示未分组。 - **说明**：普通成员、以及平台代理和动态代理的密码不会返回。 - **分页**：从 1 开始。无结果时 `dataList` 为空数组。
 - [POST /env/detail](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/getbrowserprofiledetailopenapi.md): 返回单个浏览器的完整配置，含高级指纹设置与 Cookie。 - **前置条件**：浏览器必须存在于团队中，且调用者对它有权限。 - **副作用**：无。只读。可带退避安全重试。 - **说明**：账号密码与两步验证密钥只对团队所有者返回，或在该浏览器未配置为隐藏它们时返回。
 - [POST /env/removeToRecycleBin/batch](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/batchremovebrowserprofilesopenapi.md): 把一个或多个浏览器移入回收站。 - **前置条件**：浏览器不能已在回收站中，不能正在运行，也不能处于转移中。请先关闭浏览器。 - **副作用**：软删除。数据行、指纹和云端缓存都保留，浏览器被标记为已回收并记录时间戳。套餐额度立即释放，但当日创建计数不会退回。 - **完成信号**：同步。 - **恢复**：从回收站恢复的能力未在接口层开放——请使用 MoreLogin 客户端或网页控制台。 -
 - [POST /env/lock/query](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/querybrowserprofilelockopenapi.md): 查询浏览器当前是否被其他团队成员占用。 - **副作用**：无。只读。可带退避安全重试。 - **语义**：返回 `true` 需同时满足——团队启用了安全锁功能、锁存在、且持有者不是调用者本人。锁按成员持有并带过期时间，因此它可能自行失效。
 - [POST /env/setGroup/batch](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/batchsetbrowserprofilegroupopenapi.md): 按分组名称把浏览器移入分组。 - **前置条件**：`envIds` 与 `uniqueIds` 至少提供一个；`groupName` 必填且不超过 50 字符。本接口无法清除浏览器的分组。 - **副作用**：分组名不存在时会自动创建，这会**计入团队 1000 个分组的上限**，达到上限后调用失败。一个浏览器只属于一个分组，因此原分组会被替换。当团队按分组授权时，这里新建的分组也会授权给你。
 - [POST /env/setProxy/batch](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/batchsetbrowserprofileproxyopenapi.md): 为多个浏览器绑定代理。 - **前置条件**：`envIds` 与 `uniqueIds` 至少提供一个。传入的 `proxyId` 必须已存在于团队中，否则调用被拒绝而不是自动创建。 - **副作用**：在每个浏览器上写入 `proxyId`。当 `proxyId` 省略或为 `0` 时，会复用连接信息完全相同的已有代理；**若没有匹配项，则在调用方团队中新建一条代理记录**。 - **完成信号
 - [POST /env/setRemark/batch](https://guide.morelogin.com/zh/api-reference/browser/open-api/profiles/batchsetbrowserprofileremarkopenapi.md): 批量设置浏览器备注。传空字符串表示清除备注。 - **前置条件**：`envIds` 与 `uniqueIds` 至少提供一个；调用者对每个浏览器都要有权限。 - **副作用**：只写备注字段。 - **完成信号**：同步，相同请求体完全幂等。