Fireworks AI 用户管理API

该API用于列出指定账户下的所有用户信息,支持分页、过滤、排序和字段选择等功能。

本页面仅提供API测试,调用的API服务由 Fireworks AI 提供,用量购买及管理请前往其官网。浏览器直调API,易源不做代理转发。

API密钥

密钥仅在浏览器端存储,易源不做转发

创建新用户

创建一个新用户,指定显示名称、角色和电子邮件地址

用户信息

创建结果

点击"创建用户"按钮后显示结果

功能示例

创建普通员工用户

创建用户

输入:

  • 账户ID:acc_tech_team01
  • 员工姓名:李四
  • 员工邮箱:lisi@techcompany.com
  • 用户角色:普通员工(user)

输出:

  • 用户ID:usr_lisi2023
  • 创建时间:2023-11-07 10:30:00
  • 状态:创建成功(状态码:OK)

创建管理员用户

创建用户

输入:

  • 账户ID:acc_tech_team01
  • 员工姓名:王五
  • 员工邮箱:wangwu@techcompany.com
  • 用户角色:管理员(admin)

输出:

  • 用户ID:usr_wangwu2023
  • 创建时间:2023-11-07 11:15:00
  • 状态:创建成功(状态码:OK)

查询员工用户详情

查询用户

输入:

  • 账户ID:acc_tech_team01
  • 员工ID(用户ID):usr_lisi2023

输出:

  • 员工姓名:李四
  • 邮箱:lisi@techcompany.com
  • 角色:普通员工
  • 创建时间:2023-11-07 10:30:00
  • 状态:正常(READY)

获取账户管理员列表

用户列表

输入:

  • 账户ID:acc_tech_team01
  • 筛选条件:角色=管理员
  • 每页显示:10人

输出:

  • 管理员总数:3人
  • 用户列表:
  • 1. 王五(wangwu@techcompany.com,管理员)
  • 2. 赵六(zhaoliu@techcompany.com,管理员)
  • 3. 钱七(qianqi@techcompany.com,管理员)
  • 当前页码:1

更新员工邮箱地址

更新用户

输入:

  • 账户ID:acc_tech_team01
  • 员工ID(用户ID):usr_lisi2023
  • 新邮箱:lisi-new@techcompany.com

输出:

  • 更新后邮箱:lisi-new@techcompany.com
  • 更新时间:2023-11-08 09:45:00
  • 状态:更新成功(状态码:OK)

升级员工为管理员

更新角色

输入:

  • 账户ID:acc_tech_team01
  • 员工ID(用户ID):usr_lisi2023
  • 新角色:管理员(admin)

输出:

  • 更新后角色:管理员
  • 更新时间:2023-11-08 14:20:00
  • 状态:更新成功(状态码:OK)

使用场景

企业员工账户管理

企业管理员可以通过API快速创建、查询和管理公司内部所有员工的系统账户,实现统一的用户管理。

用户角色权限控制

通过API灵活调整用户角色,区分管理员和普通用户权限,确保系统操作的安全性和合规性。

用户数据统计分析

获取用户列表数据后,可进行统计分析,了解用户分布情况、活跃度等关键指标,辅助管理决策。

多系统用户数据同步

将用户数据通过API同步到其他业务系统,确保各平台用户信息一致,提升跨系统协作效率。

用户信息批量更新

当企业有员工信息变更需求时,可通过API批量更新用户信息,如邮箱、角色等,提高管理效率。

安全审计与合规检查

定期通过API获取用户列表和权限信息,进行安全审计,确保符合企业数据安全政策和相关法规要求。

价格信息

价格由API服务商设定,详细的定价信息请参考官方文档0

查看官方价格文档

常见问题

如何获取API调用所需的认证令牌?

您需要在Fireworks AI官网注册账户并创建API密钥。登录后,在账户设置或API管理页面可以找到您的认证令牌,格式通常为"Bearer {token}"。

API调用有频率限制吗?

是的,Fireworks AI API有调用频率限制,具体限制取决于您的账户类型和订阅方案。免费账户通常有较低的调用限额,付费账户可以获得更高的调用额度。详细信息请查阅官方文档。

如何处理API返回的错误信息?

API返回的响应中包含状态码和详细的错误信息。常见错误包括认证失败、参数错误、权限不足等。您可以根据返回的错误信息调整请求参数或检查认证信息。

可以通过API删除用户吗?

当前提供的API接口主要包括创建、查询、列表和更新用户功能。删除用户功能可能需要通过其他API端点实现,或在Fireworks AI的管理控制台中操作。请查阅官方文档了解完整的API功能。

API返回的数据格式是什么?

API返回的数据格式为JSON,包含用户的各种信息如ID、姓名、邮箱、角色、创建时间等。您可以使用readMask参数指定需要返回的字段,以减少不必要的数据传输。

如何实现用户数据的分页查询?

使用pageSize参数设置每页返回的用户数量,使用pageToken参数实现分页查询。首次调用时不需要pageToken,后续调用使用前一次响应中的nextPageToken作为pageToken参数值,即可获取下一页数据。