1. Oauth2.0授权
磁力引擎
  • M-API 注册认证问题Q&A
  • M-API咨询类问题Q&A
  • 快速入门
    • 如何开通快手mapi
  • Oauth2.0授权
    • 授权流程
    • scope 权限说明
    • token管理
      • token有效期&续期
      • 获取 token
      • 刷新 token
  • 账户服务
    • 广告主
      • 获取广告账户信息
      • 获取广告账户余额信息
      • 获取广告账户流水信息
    • 账户罗盘
      • 获取罗盘绑定广告主列
      • 磁力罗盘对外 quota 腾挪接口
    • 代理商
      • 上传资质文件
      • 获取账号信息和开户资质
      • 创建或更新账户信息和开户资质
      • 创建或更新投放资质
      • 可复制账户列表
      • 复制账户
  • 广告投放
    • 账户层级
      • 账户日预算查询
      • 修改账户预算
      • 账户操作记录信息查询
    • 创编2.0(已下线)
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划预算
      • 广告组
        • 创建广告组
        • 创建联盟定投广告组
        • 创建搜索广告组
        • 创建搜索快投广告组
        • 修改广告组
        • 修改联盟定投广告组
        • 修改搜索广告组
        • 修改搜索快投广告组
        • 定向人群预估查询
        • 获取广告组信息
      • 广告创意
        • 创建创意
        • 创建程序化 2.0 创意
        • 批量创建&修改创意
        • 修改创意
        • 修改程序化 2.0 创意
        • 获取广告创意信息
        • 获取程序化创意 2.0 信息
    • 创编3.0(已下线)
      • 广告创建接口
      • 广告创建接口(广告组和广告创意)
      • 广告计划更新接口
      • 广告组更新接口
      • 广告创意更新接口(程序化创意和自定义创意)
      • 广告详情接口
      • 广告计划详情接口
      • 广告组详情接口
      • 广告创意详情接口
    • 智能化创编
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划状态
      • 广告组
        • 创建广告组
        • 修改广告组
        • 查询广告组
        • 修改广告组预算
        • 修改广告组状态
        • 修改广告组出价
      • 广告创意
        • 创建自定义创意
        • 创建程序化创意
        • 修改自定义创意
        • 修改程序化创意
        • 批量修改自定义创意
        • 查询自定义创意
        • 查询程序化创意
        • 修改创意状态
        • 创意体验
        • 创意标签填写建议
        • 获取程序化创意 2.0 审核信息
      • 批量获取监测链接接口
      • 监测链接批量更新接口
    • 高级创意
      • 获取高级创意列表
      • 创建高级创意接口
      • 删除高级创意接口
    • 搜索广告投放工具
      • 关键词管理
        • 获取关键词列表
        • 创建关键词
        • 修改关键词匹配方式
        • 修改关键词投放状态
        • 批量导出关键词
        • 获取关键词导出文件
      • 否定词管理
        • 获取否定词列表
        • 更新否定词
  • 数据报表
    • 异步任务数据报表
      • 创建历史数据查询任务
      • 获取任务状态
      • 数据下载
    • 直播报表
      • 报表新增直播数据
      • 直播间组件报表
      • 直播间报表
    • 获取原生效果数据整体概览接口(数据概览、分日转化数据分布、转化漏斗)
      POST
    • 原生效果数据报表明细接口
      POST
    • 查询原生快手号列表(for原生报表)
      POST
    • 代理商数据(t-1 数据需要第二天 9 点以后获取)
      POST
    • 广告主数据(实时)
      POST
    • 广告计划数据(实时)
      POST
    • 广告组数据
      POST
    • 广告创意数据-自定义
      POST
    • 程序化创意 2.0 数据
      POST
    • 素材报表
      POST
    • 人群分析报表
      POST
    • 小店通转化数据报表
      POST
    • 程序化落地页报表
      POST
    • 获取商品库报表
      POST
    • 关键词报表
      POST
    • 搜索词报表
      POST
    • 探索工具关键报表数据
      POST
  • 素材管理
    • 图片素材
      • 上传图片 v1 接口【逐步废弃,请使用V2接口】
      • 上传图片 v2 接口
      • 查询图片信息 get 接口
      • 查询图片接口 list 接口
      • 图片库推送
      • 获取可选的封面贴纸样式
    • 视频素材
      • 上传视频接口 v1【逐步废弃,请使用V2接口】
      • 上传视频接口 v2
      • 获取视频信息 get 接口(可通过 photo_ids 查询所有视频)
      • 获取视频信息 list 接口推荐使用,仅能查询平台&MAPI 上传,可查 uid 下所有非素造视频)
      • 批量删除视频
      • 上传图文视频
    • 视频库
      • 视频库-推送视频
      • 视频库-推送视频(新版)
      • 视频库-批量更新视频功能
      • 视频库-删除视频标签
      • 视频关联创意数查询
    • 文件上传
      • 图文音频文件MAPI上传
  • 素造平台
    • 获取素造视频接口
  • 建站管理
    • 魔力建站落地页信息查询接口
    • 魔力建站落地页批量创建接口
    • 魔力建站落地页更新CID信息
    • 魔力建站营销组件-表单查询接口
    • 魔力建站预约下载信息查询接口
    • 魔力建站落地页组信息查询接口
    • 魔力建站落地页组创建接口
    • 魔力建站落地页组更新接口
    • 魔力建站落地页组删除接口
    • 魔力建站落地页投放开关接口
  • 线索管理-老铁线索通
    • 线索通-批量创建微信小游戏
    • 线索通-获取微信小游戏列表
    • 线索 crm 信息查询接口
    • 线索 crm 意向度/进度/通话状态更新接口
    • 发起外呼接口
    • 获取通话记录
    • 线索crm赔付线索回传接口
  • DMP人群管理
    • 文件上传接口(新)
    • 人群包创建接口(新)
    • 人群包更新接口(新)
    • 人群列表查询接口
    • 人群包删除接口
    • 人群包跨账户推送
    • 人群包上线接口
    • 系统推荐定向/排除人群包
  • 联合建模
    • 样本文件上传
    • 通过上传方式新建样本
  • 工具
    • 短句
      • 通过快手号id查询授权短剧接口
      • 通过短剧id查询剧集列表
      • 获取授权的短剧作者列表
    • 查询工具
      • 创意相关
        • 获取创意推荐理由
      • 获取可选的深度优化目标
      • 获取可选的浅度优化目标
      • 获取可选的定向标签
      • 获取可选的应用定向
      • 获取可选的推荐封面
      • 获取可选的动态词包
      • 获取行动号召按钮
      • 获取可选的封面贴纸样式
      • 获取可用的转化目标
      • 获取可选白名单接口
      • 获取地域定向
      • 获取商圈地域定向
      • 获取可用咨询组件列表
      • MAPI Quota 白盒化
      • 获取创意分类查询接口
      • 快手网红-网红分类
      • 种子人群包列表
      • 快手网红-搜索快手网红
    • 功能名单
      • 获取创意分类标签白名单客户
      • 获取联盟投放白名单
    • 评论管理
      • 评论列表数据查询
      • 回复评论
      • 评论树查询
      • 屏蔽评论
      • 增加屏蔽评论信息
      • 删除屏蔽评论信息
      • 获取屏蔽评论信息列表
      • 评论管理-评论置顶
      • 评论管理-取消评论置顶
    • 应用列表
      • 获取应用列表
      • 应用权限信息列表接口
    • 行为兴趣标签-创意层级
      • 获取行为与兴趣"类目"
      • 获取行为兴趣"关键词"
    • 定向模板(新)
      • 创建定向模板
      • 更新定向模板
      • 查询定向模板
      • 删除定向模板
      • 定向模板同步
      • 模板同步失败查询
      • 查询模板关联的广告列表接口
      • 查询待升级模板列表
      • 模板升级
    • 小说库
      • 获取小说列表
      • 获取小说详情
      • 获取小说各分类枚举
      • 创建小说
      • 小说批量更新
      • 小说批量删除
      • 批量下载小说图片接口
      • 小说报表
      • 小说批量分享
    • 联盟自定义媒体包
      • 联盟定向媒体包创建
      • 联盟定向媒体包修改
      • 联盟定向媒体包删除
      • 获取联盟定向媒体包列表
      • 联盟定向媒体包广告位报表
    • 游戏试玩
      • 上传试玩素材
      • 直存试玩
      • 获取试玩按钮列表
      • 获取试玩列表
      • 试玩推送
      • 查看共享账户
    • 商品库
      • 商品库各行业商品数据校验规则
      • 查询 DPA 模板信息
      • 获取商品库列表
      • 获取商品库类目树
      • 创建商品
      • 更新商品
      • 获取商品列表
      • 获取商品列表(部分信息)
      • 获取商品列表(游标)
      • 获取SDPA创意视频模板
      • 批量模板合成SDPA创意视频
    • 出价建议
      • 批量获取广告组出价建议
      • 获取广告组曝光、转化预估
      • 获取广告组投放预估曲线
    • 直播推广
      • 获取主播列表
      • 获取直播间小铃铛列表
    • 探索工具
      • 一键复苏开启
      • 一键复苏关闭
      • 加速探索-开启接口
      • 加速探索关闭
      • 辅助探索开启
      • 探索工具状态查询
      • 探索工具报表
      • 探索工具使用记录
      • 探索工具关键报表数据
    • 智能托管
      • 枚举说明
      • 智能托管创建及更新接口
      • 智能托管状态更新
      • 智能托管删除接口
      • 获取智能托管详情接口
      • 获取智能托管物料接口
      • 智能托管报表接口
      • 分小说展开效果数据接口
    • 投前预估
      • 创建投前预估任务
      • 投前预估详情
      • 投前预估列表
      • 投前预估任务管理
    • 原生广告投放工具
      • 隐藏视频同步至个人主页
      • 获取快手号授权列表
      • 快手号授权接口
      • 获取达人原生视频列表接口
      • 共享授权接口
      • 共享授权结果
      • 共享授权-获取已共享授权授权记录
      • 获取原生快手号列表接口
      • 本地视频上传接口
  • 频控和创建限制
    • 频控和创建限制
    • 接口调用分级使用
  • 磁力聚星
    • 投后数据
      • 星视频--查询订单的投后数据
      • 星任务(视频)-查询任务的投后数据
      • 星任务(视频)-查询订单的投后数据
  • 转化归因
    • 转化归因信息合辑
      • 转化归因信息合辑
  • 应用管理
    • 接入前言
    • 文件上传【必选】
      • 【应用中心】上传 APK 文件
      • 【应用中心】上传图片
    • 应用创编【必选】
      • 【应用中心】创建 Android 应用
      • 【应用中心】创建 iOS 应用
      • 【应用中心】编辑 Android 应用
      • 【应用中心】更新 iOS 应用
    • 应用查询For单元投放【必选】
      • 获取新版应用发布列表【单元创编】
      • 获取新版分包发布列表【单元创编】
    • 应用查询For应用中心【可选】
      • 【应用中心】获取应用列表
      • 【应用中心】获取应用详情
    • 应用共享【可选】
      • 【应用中心】添加应用共享
      • 【应用中心】取消应用共享
      • 【应用中心】获取应用已共享账号列表
      • 【应用中心】获取应用已共享主体列表
      • 【应用中心】获取单个主体下共享账号列表
      • 【应用中心】获取可共享的主体列表
      • 【应用中心】获取可共享的账号列表
    • 应用操作【可选】
      • 【应用中心】iOS 应用上报更新
      • 【应用中心】发布应用
      • 【应用中心】应用上架
      • 【应用中心】应用下架
      • 【应用中心】应用商店上下架
    • 应用分包【可选】
      • 【应用中心】新建应用分包
      • 【应用中心】更新/恢复/删除应用分包
      • 【应用中心】修改应用分包备注
      • 【应用中心】获取分包管理/回收站列表
      • 【应用中心】分包失败,重新构建
    • 其他接口【可选】
      • 【应用中心】获取应用尚未发布的最新的应用包信息
      • 【应用中心】获取应用版本记录
      • 获取新版应用发布详情
      • 人群包数据
  • 附录
    • 3.0创编接口改动
    • 报错 code 枚举值
  1. Oauth2.0授权

授权流程

1.
注册成为开发者后,需要在应用管理中填写应用内容生成对应应用。
2.
需要填写内容:
应用名称:50 个字符限制,便于区分 app_id 及用途
应用图标:格式为 JPG/PNG,大小不超过 1M,图片比例需为 1:1。
应用描述:不少于 2 字符,便于描述应用特点。
回调地址:必须为链接格式,其他无特殊限制,主要为了为授权完成后进行跳转,将 auth_code 等信息通过该地址返回,客户可进行自动授权等操作。
3.
授权链接示例: https://developers.e.kuaishou.com/tools/authorize?app_id=应用ID&scope=权限范围&redirect_uri=回调地址xxx&state=abcd&oauth_type=授权类型
参数描述值(示例)备注
app_id应用 ID1申请应用后快手返回的 app_id
scope权限范围%5B%22report_service%22%5D可在各功能模块文档中获取对应的权限 code,参数值原始格式:"report_service","xxxxxxx","……",使用时需要 UrlEncode 一次"ad_query","ad_manage","report_service","account_service"
redirect_uri回调地址https://e.kuaishou.com申请应用时开发者提供的回调地址,使用时需要 UrlEncode 一次
oauth_type授权类型oauth_type = advertiser广告主/服务商:advertiser;代理商:agent;聚星:ad_social; 短剧开发者:series
state自定义参数abcd回调时会原样返回,可用于广告主区分不同投放渠道等用途,广告主可选择性使用
oauth_type=advertiser,广告主/服务商
广告主:仅能操作广告主体下广告投放账户,可使用罗盘罗盘账户进行批量授权。
服务商:可授权平台任何主体账户,但是需要双向授权成功。
oauth_type=agent,代理商
代理商:仅能操作代理商管辖广告投放账户,可使用 1 个 token 调用管辖所有账户。
服务商:可授权平台任何代理商主体,但是需要双向授权成功。
oauth_type=ad_social,聚星
聚星:需要校验聚星的账号是否一致
修改于 2023-10-23 05:45:48
上一页
如何开通快手mapi
下一页
scope 权限说明
Built with