# 绑定千问应用

`POST` `/api/qwen-onboarding/bind`

绑定千问应用与当前租户的点金智能体，颁发 issued 凭证（仅本次明文回显，请妥善保存），并返回注册到千问侧所需的 Agent Card URL 与 A2A 端点URL。相同千问appId不可重复绑定。

## 请求参数

### 请求体（JSON）

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| qwenAppId | string | 是 | 千问侧应用app_id，全局唯一 |
| qwenClientId | string | 是 | 千问颁发的client_id |
| qwenClientSecret | string | 是 | 千问颁发的client_secret |
| agentId | integer | 是 | 点金侧智能体ID，须归属当前租户 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | QwenOnboardingBindVO | 响应数据 |
|     id | integer | 入驻配置主键ID |
|     issuedClientId | string | 点金颁发给千问的client_id |
|     issuedClientSecret | string | 点金颁发给千问的client_secret，仅本次明文回显，请妥善保存 |
|     agentCardUrl | string | Agent Card 对外URL，注册到千问侧 |
|     a2aEndpointUrl | string | A2A 端点URL |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |