> 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.

# 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`。

## 支持平台

<table>
<thead>
<tr><th>平台</th><th>支持情况</th></tr>
</thead>
<tbody>
<tr><td>Android</td><td>支持</td></tr>
<tr><td>iOS</td><td>支持</td></tr>
<tr><td>PC</td><td>不支持</td></tr>
<tr><td>HarmonyOS</td><td>不支持</td></tr>
</tbody>
</table>

## 支持场景

<table>
<thead>
<tr><th>场景</th><th>支持情况</th></tr>
</thead>
<tbody>
<tr><td>页面</td><td>支持</td></tr>
<tr><td>卡片</td><td>支持</td></tr>
</tbody>
</table>

## 接入准备

### 前置条件

- **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

```typescript
postLoginResult(params: PostLoginResultRequest): Promise<object>
```

## 入参

<table>
<thead>
<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
</thead>
<tbody>
<tr><td><code>code</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>-</td><td>三方短期兑换 code，仅在 `result` 为 `true` 时有效且必填。<br><br>该字段必须由业务服务端生成。豆包服务端会使用它调用业务方配置的 OAuth Token endpoint，<br>换取三方颁发的 MCP AccessToken 和 RefreshToken。<br><br>不要传入 `login()` 返回的豆包 `login_code`，也不要直接传入 AccessToken 或 RefreshToken。Android、iOS：result 为 true 时若 code 缺省或为空，双端均按失败处理（Android reject、iOS reject）。</td></tr>
<tr><td><code>result</code></td><td><code>boolean</code></td><td>是</td><td>-</td><td>-</td><td>三方登录是否成功。<br><br>`true` 表示三方已完成业务账号登录，并提供了可供豆包兑换 MCP Token 的短期 code；<br>`false` 表示用户拒绝登录或登录失败。Android、iOS：Android 在 result 为 false 时正常 resolve，iOS 在 result 为 false 时以失败 reject（message 为 &quot;no login result&quot;）。</td></tr>
</tbody>
</table>

## 调用示例

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

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

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

## 成功返回

无返回字段。

## 错误处理

错误对象和通用错误码见 [通用错误处理](/apps-plugin/docs/js-api/common-errors.md#错误返回)。

### 失败示例

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

### 错误码

<table>
<thead>
<tr><th>errNo</th><th>errMsg</th><th>平台</th><th>触发条件</th><th>处理建议</th></tr>
</thead>
<tbody>
<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>Android</td><td>result 为 true 但缺少有效的兑换 code</td><td>传入业务服务端生成的有效 code 后重试。</td></tr>
<tr><td><code>105</code></td><td><code>authentication fail</code></td><td>Android、iOS</td><td>登录被拒绝或兑换 code 校验未通过</td><td>确认业务登录状态与 code 是否有效后重试。</td></tr>
<tr><td><code>112</code></td><td><code>invalid result</code></td><td>Android、iOS</td><td>Token 交换服务返回的数据无法解析</td><td>稍后重试；持续失败时反馈服务端响应异常。</td></tr>
<tr><td><code>115</code></td><td><code>operation timeout</code></td><td>Android</td><td>Token 交换耗时超过限制</td><td>检查网络后重试。</td></tr>
<tr><td><code>301</code></td><td><code>network request cancelled</code></td><td>iOS</td><td>Token 交换的网络请求被取消</td><td>确认应用和网络状态后重试。</td></tr>
<tr><td><code>302</code></td><td><code>connection timed out</code></td><td>Android、iOS</td><td>Token 交换的网络连接超时</td><td>检查网络连接后重试。</td></tr>
<tr><td><code>303</code></td><td><code>no network connection</code></td><td>Android、iOS</td><td>当前无可用网络连接</td><td>恢复网络连接后重试。</td></tr>
<tr><td><code>305</code></td><td><code>network failure</code></td><td>Android、iOS</td><td>Token 交换时发生其他网络错误</td><td>检查网络连接，稍后重试。</td></tr>
</tbody>
</table>

#### 通用错误码

<table>
<thead>
<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
</thead>
<tbody>
<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
</tbody>
</table>

## 平台差异

- **Android**：缺少有效 code 时返回 104；调用超时返回 115。
- **iOS**：缺少有效 code 时返回 102；网络请求被取消时返回 301，超时归类为 302。
