---
title: "平台列表"
method: GET
path: "/api/v2/channels/platforms"
tags: ["渠道管理/平台"]
---

# 平台列表

`GET /api/v2/channels/platforms`

接口说明：返回已注册平台的元数据列表，包括展示名、logo、能力声明等

## Response `200`

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

- object
  - `data` PlatformMetadataVo[]
    - `platform` 'douyin' | 'xhs' | 'wxSph' | 'KWAI' | 'youtube' | 'wxGzh' | 'bilibili' | 'twitter' | 'tiktok' | 'facebook' | 'instagram' | 'threads' | 'pinterest' | 'linkedin' | 'google_business', required — 平台
    - `displayName` object, required — 展示名
      - `en-US` string, required — 英文文案
      - `zh-CN` string, required — 中文文案
    - `logoUrl` string, uri, required — 平台 logo URL
    - `authType` 'oauth2' | 'browser' | 'plugin' | 'qrcode', required — 授权类型
    - `authInstructions` object — 授权操作提示语
      - `en-US` string, required — 英文文案
      - `zh-CN` string, required — 中文文案
    - `emptyAccountHint` object — 空账号引导提示
      - `title` object, required — 空账号提示标题
        - `en-US` string, required — 英文文案
        - `zh-CN` string, required — 中文文案
      - `description` object, required — 空账号提示描述
        - `en-US` string, required — 英文文案
        - `zh-CN` string, required — 中文文案
      - `action` object — 操作按钮
        - `label` object, required — 操作按钮文案
          - `en-US` string, required — 英文文案
          - `zh-CN` string, required — 中文文案
        - `url` string, uri, required — 操作链接
    - `editor` 'none' | 'text' | 'html', required — 编辑器类型
    - `contentLimits` object, required — 内容限制
      - `modes` string[], required — 支持的发布内容模式
      - `maxTitleLength` number — 标题最大长度
      - `maxBodyLength` number — 正文最大长度
      - `maxTotalTextLength` number — 最终发布文本最大长度
      - `maxMediaCount` number — 媒体最大数量
      - `maxImages` number — 图片最大数量
      - `maxVideos` number — 视频最大数量
    - `mediaRules` object, required — 媒体规则
      - `imageFormats` string[] — 图片格式
      - `videoFormats` string[] — 视频格式
      - `maxImageSize` number — 图片最大字节数
      - `maxVideoSize` number — 视频最大字节数
      - `minVideoDuration` number — 视频最小秒数
      - `maxVideoDuration` number — 视频最大秒数
      - `minImageWidth` number — 图片最小宽度
      - `minImageHeight` number — 图片最小高度
      - `maxImageWidth` number — 图片最大宽度
      - `maxImageHeight` number — 图片最大高度
      - `aspectRatio` object — 宽高比限制
        - `min` number — 最小宽高比
        - `max` number — 最大宽高比
    - `topic` object, required — 话题能力
      - `supported` boolean, required — 是否支持话题
      - `nativeField` boolean — 是否使用平台原生话题字段
      - `maxCount` number — 话题最大数量
      - `maxTotalLength` number — 话题序列化后的最大总长度
    - `capabilities` object, required — 平台操作能力
      - `auth` object, required — 授权能力
        - `supported` boolean, required — 是否支持授权
        - `revoke` boolean, required — 是否支持取消授权
        - `selectableAccounts` boolean, required — 是否支持授权后选择子账号
        - `refreshAccountAccess` boolean, required — 是否支持刷新子账号访问凭证
      - `publish` object, required — 发布能力
        - `supported` boolean, required — 是否支持服务端发布
        - `cancel` boolean, required — 是否支持取消平台侧发布
        - `update` boolean, required — 是否支持更新已发布内容
        - `verify` boolean, required — 是否支持发布结果验证
        - `finalize` boolean, required — 是否支持发布后轮询或收尾
        - `scheduleByPlatform` boolean, required — 是否支持平台原生定时发布
        - `optionSources` boolean, required — 是否支持动态发布选项
        - `completionStrategy` 'sync' | 'polling' | 'media_finalize' | 'webhook' | 'user_handoff' — 发布完成策略
      - `analytics` object, required — 数据分析能力
        - `account` boolean, required — 是否支持账号数据分析
        - `work` boolean, required — 是否支持作品数据分析
      - `engagement` object, required — 互动能力
        - `comments` object, required — 评论能力
          - `list` object, required — 评论列表能力
            - `supported` boolean, required — 是否支持评论列表
            - `pagination` union, required — 评论列表分页能力
              - …
            - `parameters` object, required — 评论列表参数
              - …
          - `create` object, required — 创建评论能力
            - `supported` boolean, required — 是否支持创建评论
            - `parameters` object, required — 创建评论参数
              - …
        - `functions` object[], required — 平台支持的互动函数
          - `name` 'delete_comment' | 'like' | 'unlike' | 'repost' | 'undo_repost' | 'quote' | 'bookmark' | 'remove_bookmark' | 'hide_reply' | 'unhide_reply' | 'follow' | 'unfollow', required — 互动函数名称
          - `label` object, required — 函数展示文案
            - `en-US` string, required — 英文文案
            - `zh-CN` string, required — 中文文案
          - `target` 'work' | 'comment' | 'account', required — 互动目标类型
          - `parameters` object, required — 函数参数
            - `querySchema` object, required — Query 参数 JSON Schema
            - `bodySchema` object, required — Body 参数 JSON Schema
            - `dataSchema` object, required — 函数 data 参数 JSON Schema
      - `work` object, required — 作品能力
        - `listWorks` boolean, required — 是否支持账号作品列表
        - `listWorksPagination` union, required — 账号作品列表分页能力
          - object
            - `mode` 'cursor', required — 分页模式
            - `defaultLimit` integer, required — 默认数量
            - `maxLimit` integer, required — 最大数量
            - `supportsPrevious` boolean, required — 是否支持上一页
          - object
            - `mode` 'page', required — 分页模式
            - `defaultPageSize` integer, required — 默认每页数量
            - `maxPageSize` integer, required — 最大每页数量
            - `supportsTotal` boolean, required — 是否返回总数
          - object
            - `mode` 'none', required — 分页模式
        - `getLinkInfo` boolean, required — 是否支持解析作品链接
        - `getDetail` boolean, required — 是否支持作品详情
        - `verifyOwnership` boolean, required — 是否支持作品归属校验
      - `browse` object, required — 浏览能力
        - `search` boolean, required — 是否支持搜索浏览
        - `getDetail` boolean, required — 是否支持浏览详情
      - `webhook` object, required — Webhook 能力
        - `supported` boolean, required — 是否支持 webhook
    - `optionSchema` object, required — 发布选项 JSON Schema
    - `defaultOption` object — 默认发布选项
    - `status` 'hidden' | 'available' | 'unavailable' | 'coming_soon', 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)
