Skip to main content
POST
重置成员信息

限制说明

使用说明

  • 使用 member_idmember_nameemailphoneref_id 中任一字段定位成员;如果同时传多个字段,服务端按上述顺序匹配。
  • updates.country_code 为 ISO 3166-1 alpha-2 地区代码(如 “CN”、“US”)。它是独立可更新字段:无需同时传 updates.phone,即使手机号不变也会写入新的地区代码;显式传空字符串会被拒绝(400)。
  • updates.phone 不带 ”+” 前缀时,按 updates.country_code 作为地区提示解析;未传时依次回退到成员已存的地区代码、默认值 “CN”。“86” 等数字电话区号仅在解析场景兼容,存储值一律为 ISO 地区代码。
  • 顶层的 country_code 仅作为定位用 phone 的解析提示,不会被存储。
  • updates 承载要写入的新资料,支持 member_namepasswordphonecountry_codeemailavatarlocaletime_zoneref_id
  • 由 SSO 托管且不可编辑的成员不能通过此接口修改。
  • updates 至少要带一个字段;所有字段都不传的空对象会被拒绝。

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

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
必填

空响应