For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/js-api/open/login/postLoginResult.md.

postLoginResult

向豆包回传三方 MCP 授权登录结果。

使用限制

WARNING

Android、iOS:Android 在 result 为 false 时正常 resolve,iOS 在 result 为 false 时以失败 reject(message 为 "no login result");调用方无法用统一方式判断失败结果是否已回传成功。 Android、iOS:result 为 true 时若 code 缺省或为空,双端均按失败处理(Android reject、iOS reject);调用方误以为成功回传可省略 code。

支持版本

前端库版本不低于 0.0.19。

支持平台

平台支持情况
Android支持
iOS支持
PC不支持
HarmonyOS不支持

支持场景

场景支持情况
页面支持
卡片支持

接入准备

前置条件

  • Android:先完成登录,并传入登录成功返回的有效 code
  • iOS:先完成登录,并传入登录成功返回的有效 code

使用说明

仅在 MCP 授权登录流程中调用此 API。业务服务端应先使用 login() 返回的一次性 login_code 换取 OpenID、完成业务账号登录或绑定,再生成用于 OAuth Token 交换的三方短期 code。

result 为 true 时必须传入 code。豆包使用该 code 完成 Token 交换后会自动关闭 MCP 登录页。 用户拒绝登录或登录失败时,传入 { result: false },不要继续请求用户数据。

MCP AccessToken、RefreshToken 及其生命周期由业务服务端维护,不应下发到前端。

  • 仅在完成 MCP 授权登录流程后回传结果;登录成功时必须携带有效 code,回传成功后不要重复回传。

调用方式

异步 API

postLoginResult(params: PostLoginResultRequest): Promise<object>

入参

名称类型必填默认值约束说明
codestring否--三方短期兑换 code,仅在 `result` 为 `true` 时有效且必填。

该字段必须由业务服务端生成。豆包服务端会使用它调用业务方配置的 OAuth Token endpoint,
换取三方颁发的 MCP AccessToken 和 RefreshToken。

不要传入 `login()` 返回的豆包 `login_code`,也不要直接传入 AccessToken 或 RefreshToken。Android、iOS:result 为 true 时若 code 缺省或为空,双端均按失败处理(Android reject、iOS reject)。
resultboolean是--三方登录是否成功。

`true` 表示三方已完成业务账号登录,并提供了可供豆包兑换 MCP Token 的短期 code;
`false` 表示用户拒绝登录或登录失败。Android、iOS:Android 在 result 为 false 时正常 resolve,iOS 在 result 为 false 时以失败 reject(message 为 "no login result")。

调用示例

import {
  postLoginResult,
  type PostLoginResultRequest
} from '@doubao-dev/framework/api';

// 业务方自行实现:完成业务登录并生成三方短期兑换 code;该函数不是 SDK API。
declare function getMcpLoginResultFromBusinessServer(): Promise<PostLoginResultRequest>;

const loginResult = await getMcpLoginResultFromBusinessServer();
await postLoginResult(loginResult);

成功返回

无返回字段。

错误处理

错误对象和通用错误码见 通用错误处理。

失败示例

{
  "errNo": 105,
  "errMsg": "authentication fail"
}

错误码

errNoerrMsg平台触发条件处理建议
104invalid parameterAndroidresult 为 true 但缺少有效的兑换 code传入业务服务端生成的有效 code 后重试。
105authentication failAndroid、iOS登录被拒绝或兑换 code 校验未通过确认业务登录状态与 code 是否有效后重试。
112invalid resultAndroid、iOSToken 交换服务返回的数据无法解析稍后重试;持续失败时反馈服务端响应异常。
115operation timeoutAndroidToken 交换耗时超过限制检查网络后重试。
301network request cancellediOSToken 交换的网络请求被取消确认应用和网络状态后重试。
302connection timed outAndroid、iOSToken 交换的网络连接超时检查网络连接后重试。
303no network connectionAndroid、iOS当前无可用网络连接恢复网络连接后重试。
305network failureAndroid、iOSToken 交换时发生其他网络错误检查网络连接,稍后重试。

通用错误码

errNoerrMsg说明平台
102internal error内部错误Android、iOS

平台差异

  • Android:缺少有效 code 时返回 104;调用超时返回 115。
  • iOS:缺少有效 code 时返回 102;网络请求被取消时返回 301,超时归类为 302。