快手 API
  1. 获取推流地址接口
快手 API
  • 萌新必读
    • 平台介绍
    • 开发者入驻
    • 应用注册
    • 基础信息修改
  • 接入指引
    • Android 接入
    • 网站应用接入
    • 快手服务端SDK接入- java版本
    • iOS 接入
      • 接入指南
      • 功能使用
  • 开放能力
    • 快手登录
      • 说明文档
      • code2AccessToken
      • refreshToken
    • 用户信息
      • 公开信息
        • GetUserInfo
      • 手机号
        • GetUserPhone
      • 关系链
    • 内容管理
      • 创建视频
        • 发起上传
          • 发起上传
        • 上传视频
          • A 直接上传
            • A.1 二进制body方式
            • A.2 Multipart Form Data方式
          • B 分片上传
            • B.1 上传分片
            • B.2 断点续传
            • B.3 完成分片上传
        • 发布视频
          • 发布视频
      • 删除视频
        • 删除视频
      • 查询视频
        • 查询用户视频列表
        • 查询单一视频详情
        • 查询视频数量接口
    • 直播
      • 概述
      • 直播托管模式
      • 获取推流地址接口
        • 人脸识别
        • 获取推流地址接口
          POST
      • create_QRcode
        GET
      • get_live_scene
        GET
      • 结束直播接口
        POST
      • 获取直播状态信息
        GET
    • WebHook
      • 接入指南
      • 事件列表
        • 测试事件
        • 授权事件
        • 解除授权事件
    • 粉条
      • 粉条服务接入指南
      • 直播接口
        • 获取定向配置
        • 获取出价配置
        • 获取钱包配置
        • 获取可投放作品
        • 生成订单ID
        • 下订单
        • 关闭订单
        • 获取订单列表
        • 获取订单信息
        • 获取订单效果
      • 内容接口
        • 获取定向配置-photo
        • 查询相似粉丝定向行业和达人
        • 模糊搜索相似粉丝达人
        • 获取用户与行业的dmpId
        • 获取钱包配置
        • 获取推荐价格列表(入门版)
        • 根据价格获取购量(入门版)
        • 获取期望提升
        • 获取推荐出价与价格区间(出价版)
        • 不出价版创建订单
        • 出价版创建订单
        • 关闭订单
        • 查询订单效果
  • 其他
    • 错误码
    • 联系我们
    • 常见问题
  1. 获取推流地址接口

人脸识别

1.获取推流地址时如果账户命中风控且需要人脸识别的话,接口会返回人脸识别验证信息content,其中content包含以下字段(注:命中其他拦截时,content返回null,这种情况下无法开播)#

字段类型备注
verifyErrorMsgString人脸识别拦截提示信息
verifyErrorCodeint人脸识别拦截提示错误码 0:获取验证url成功 1:操作过于频繁 2:获取验证url失败
envokeKwaiFaceVerifyUrlString人脸识别拦截唤起快手app的url
envokeKsnebulaFaceVerifyUrlString人脸识别验证唤起快手极速版app的url
qrCodeFaceVerifyUrlString人脸识别拦截二维码url
返回示例:
//返回值示例(账号命中风控)
{
    "result": 400020,
    "content": {
        "verifyErrorMsg": "人脸识别拦截,请通过url进行人脸验证,验证成功后请重新开播",
        "verifyErrorCode": 0,
        "qrCodeFaceVerifyUrl": "https%3A%2F%2Fapp.m.kuaishou.com%2Fzt%2Funified%2Ftools%2Fverification%2Funified%2Fface-recognition%3FneedQrcode%3D1%26needQrType%3Didentity-verify-face%26bizNameForIdCardVerify%3DLIVE_STREAM_START%26ticket%3DChxrdWFpc2hvdS5hcGkuc21zLnZlcmlmaWVkLmF0EnBCAIB2uGew_zdD1b5xfDMglQjxK6FNt52B5nH1xzLgglEqCrI_8HTF56OdUh04Us8gq4nWOqFH-ljbMshJvJfYUjm3i9ZkM0ABt-nYYlhG9naLSo3yyP_WSqOpWb77CEXqlJlHeDASukRlZDqUhdXGhKaNLsg0qqYooMY2RvrtKfkFHMiIGLoC8eItdDHKhElYU9ZsDV24bqTFrZ5EoGIpUtdxmHyKAUwAQ",
        "envokeKwaiFaceVerifyUrl": "kwai://recognition?appId=ks674132570997063184&recognitionUrl=https%3A%2F%2Fapp.m.kuaishou.com%2Fzt%2Funified%2Ftools%2Fverification%2Funified%2Fface-recognition%3FneedQrcode%3D1%26needQrType%3Didentity-verify-face%26bizNameForIdCardVerify%3DLIVE_STREAM_START%26ticket%3DChxrdWFpc2hvdS5hcGkuc21zLnZlcmlmaWVkLmF0EnBCAIB2uGew_zdD1b5xfDMglQjxK6FNt52B5nH1xzLgglEqCrI_8HTF56OdUh04Us88gq4nWOqFH-ljbMshJvJfYUjm3i9ZkM0ABt-nYYlhG9naLSo3yyP_WSqOpWb77CEXqlJlHeDASukRlZDqUhdXGhKaNLsg0qqYooMY2RvrtKfkFHMiIGLoC8eItdDHKhElYU9ZsDV24bqTFrZ5EoGIpUtdxmHyKAUwAQ",
        "envokeKsnebulaFaceVerifyUrl": "ksnebula://recognition?appId=ks674132570997063184&recognitionUrl=https%3A%2F%2Fapp.m.kuaishou.com%2Fzt%2Funified%2Ftools%2Fverification%2Funified%2Fface-recognition%3FneedQrcode%3D1%26needQrType%3Didentity-verify-face%26bizNameForIdCardVerify%3DLIVE_STREAM_START%26ticket%3DChxrdWFpc2hvdS5hcGkuc21zLnZlcmlmaWVkLmF0EnBCAIB2uGew_zdD1b5xfDMglQjxK6FNt52B5nH1xzLgglEqCrI_8HTF56OdUh04Us88gq4nWOqFH-ljbMshJvJfYUjm3i9ZkM0ABt-nYYlhG9naLSo3yyP_WSqOpWb77CEXqlJlHeDASukRlZDqUhdXGhKaNLsg0qqYooMY2RvrtKfkFHMiIGLoC8eItdDHKhElYU9ZsDV24bqTFrZ5EoGIpUtdxmHyKAUwAQ"
    },
    "hostName": "bjfk-rs12223.yz02"
}
前提:未在快手App内进行实名认证的请先进行实名认证。
(1)二维码url的使用方式:(qrCodeFaceVerifyUrl)
1.1 成功返回拦截信息后,content.qrCodeFaceVerifyUrl内容即为二维码的url,包含一些验证的信息,需要转化为图片地址url或请求官方提供的api并获取返回结果才能在h5,web,客户端,pc端等渲染出来,可自行使用工具转化,也可参考下文生成二维码服务。
1.2 获取到二维码图片地址后展示给主播,主播使用快手app完成扫码验证后,重新开播即可成功。
(2)唤起快手app的url的使用方式:(envokeKwaiFaceVerifyUrl、envokeKsnebulaFaceVerifyUrl)
1.1 成功返回拦截信息后,content.envokeKwaiFaceVerifyUrl内容即为快手app的kwai链协议验证url、content.envokeKsnebulaFaceVerifyUrl内容即为快手极速版app的kwai链协议验证url,都包含了一些验证的信息,三方开发人员根据自身情况触发对应kwai链协议即可跳转到对应的快手官方app。三方客户端触发方式见下方唤起人脸识别验证。
1.2 跳转到对应的快手官方app后,主播进行人脸识别验证,完成验证后重新开播即可成功。

2.操作频繁请稍后重试,时间间隔为1s#

返回示例:
{
    "result": 400020,
    "content": {
        "verifyErrorMsg": "操作频繁",
        "verifyErrorCode": 1,
        "qrCodeFaceVerifyUrl": "",
        "envokeKwaiFaceVerifyUrl": "",
        "envokeKsnebulaFaceVerifyUrl": ""
    },
    "hostName": "bjfk-rs12223.yz02"
}
扫码后验证过程如图:
img

3.唤起人脸识别验证#

注:要求快手app和快手极速版app的双端版本限制:≥9.8.50
Android端
    //从server获得唤起快手的url
    Uri uri = Uri.parse(url);
    Intent intent = new Intent(Intent.ACTION_VIEW, uri);
    startActivity(intent);
iOS端
    // 从 server 获取唤起快手的 URL。
    NSURL *URL = [NSURL URLWithString:@""];
    // 唤起快手,进行实名认证。
    [[UIApplication sharedApplication] openURL:URL options:@{} completionHandler:nil];

【快手】API开发者 微信交流群

用微信扫右侧二维码,加入【快手】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2021-11-23 07:42:18
上一页
直播托管模式
下一页
获取推流地址接口
Built with