跳转到主要内容
POST
重置成员信息

限制说明

使用说明

  • 使用 member_id、member_name、email、phone 或 ref_id 中任一字段定位成员;如果同时传多个字段,服务端按上述顺序匹配。
  • 调用者必须是账户主体、该成员本人或拥有 Admin 角色,否则返回 403 AccessDenied。
  • updates 承载要写入的新资料,支持 member_name、password、phone、country_code、email、avatar、locale、time_zone、ref_id。省略或为 null 的字段保持原值;updates 至少要带一个字段。
  • 新的 member_name、email、phone 不能已属于本账户其他成员,冲突时返回 400。修改后的 email 或 phone 会被标记为未验证,除非 from 为 api、账户关闭了成员邀请,且被修改的成员不是调用者本人。
  • updates.time_zone 传空字符串会清除成员自己的时区,使其跟随账户时区。
  • updates.country_code 为 ISO 3166-1 alpha-2 地区代码(如 “CN”、“US”)。它是独立可更新字段:无需同时传 updates.phone,即使手机号不变也会写入新的地区代码;显式传空字符串会被拒绝(400)。
  • 当 updates.phone 不带 ”+” 前缀时,按 updates.country_code 作为地区提示解析;未传时依次回退到成员已存的地区代码、默认值 “CN”。“86” 等数字电话区号仅在解析场景兼容,存储值一律为 ISO 地区代码。
  • 顶层的 country_code 仅作为定位用 phone 的解析提示,不会被存储。
  • 各字段逐个写入;若后面的字段校验失败,同一次调用中已写入的字段不会回滚。
  • 通过单点登录同步的成员,在单点登录配置将其设为不可编辑,或账户已无生效的单点登录配置时无法修改。
  • 同一账户内并发的资料更新或成员邀请可能返回 429 RequestTooFrequently,请稍后重试。
  • 每次调用都会记录到账户审计日志,请不要把敏感信息放在请求字段中。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

application/json

重置成员信息请求。外层字段用于定位成员,updates 用于传入要写入的新资料。

member_id
integer<uint64>
必填

用于定位成员的成员 ID。

updates
object
必填

要写入的成员资料新值,至少包含一个字段。

member_name
string

用于定位成员的成员名称。

email
string

用于定位成员的邮箱地址。

phone
string

用于定位成员的手机号;如不是 E.164 格式,可同时传 country_code。

country_code
string

当 phone 不带 "+" 前缀时的解析地区提示 —— ISO 3166-1 alpha-2 地区代码(如 "CN",未传时默认 "CN")。此解析场景仍兼容 "86" 等数字电话区号。

ref_id
string

用于定位成员的外部引用 ID。

from
string

传 api 可将更新后的手机号或邮箱标记为已验证。仅在账户关闭成员邀请且被修改的成员不是调用者本人时生效,其他取值均被忽略。

响应

成功

成功响应结构。2xx 响应中 request_id 标识本次调用(同时出现在 Flashcat-Request-Id 响应头中),data 为接口业务 payload。失败响应使用不同结构,参见 ErrorResponse。

request_id
string
必填

本次请求的唯一 ID,也会在 Flashcat-Request-Id 响应头中返回。反馈问题时请一并附上。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

空响应