跳到文档正文
浏览和搜索
本页内容

request_confirmation_code

为一项暂存的变更向对方邮箱发送 6 位验证码,邮件中写明变更内容、价格和日期。验证码随暂存变更一起过期;再次申请会替换之前的验证码。read 级:只需 API key。同名 MCP 工具需要 tweetstream:billing 权限范围。

POST/api/agent/actions/request_confirmation_code

授权

  • Authorizationstringheader必填使用 TweetStream API 密钥进行 Bearer 认证:Bearer <key>。

请求体

  • pendingActionIdstring必填a string at most 64 character(s) long

响应字段

  • challengeIdstring必填
  • expiresAtstring必填a string to be decoded into a Date
  • nextobject必填
    • actionenum<string>必填
    • messagestring必填
    • namestring必填
    • whoenum<string>必填

响应

  • 200成功
  • 400输入不符合该操作的 schema(INVALID_REQUEST)
  • 401API key 缺失或无效
  • 403请求带有外部 Origin
  • 404此 API key 下没有该 pendingActionId 对应的暂存变更(CONFIRMATION_NOT_FOUND)
  • 409暂存的变更已过期(CONFIRMATION_EXPIRED)或已确认(ACTION_REFUSED)
  • 429已达到速率限制(RATE_LIMITED),请在 retryAfterSeconds 秒后重试
  • 503暂时不可用,请稍后重试