---
title: "发起平台授权"
method: GET
path: "/api/v2/channels/accounts/auth/{platform}"
tags: ["渠道管理/授权"]
---

# 发起平台授权

`GET /api/v2/channels/accounts/auth/{platform}`

接口说明：生成平台 OAuth 授权 URL

## Path parameters

- `platform` string, required

## Query parameters

- `callbackUrl` string, uri — 授权完成后浏览器 POST relay 的回调地址
- `redirectUri` string, uri — 授权完成后浏览器跳转地址
- `groupId` string — 账号组 ID，不传则使用默认组

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` AuthStartVo
    - `url` string, required — 平台授权 URL 或二维码图片 data URL
    - `sessionId` string, required — 授权 Session ID
    - `expiresAt` string, date-time, required — 授权 Session 过期时间
    - `authInstructions` object — 授权操作提示语
      - `en-US` string, required — 英文文案
      - `zh-CN` string, required — 中文文案
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)