开发文档
总目录
接入常见问题
开发者平台使用帮助
HTTP API接口文档
Chatbot接口指令说明文档
Android SDK用户接入指南
微信公众号客服机器人接入教程
灵聚智能助理app开源说明文档
直播数字人系统用户评论回复接口开发文档
灵聚自定义对话训练API接口说明文档
本站点使用 MrDoc 构建
-
+
直播数字人系统用户评论回复接口开发文档
# 直播数字人系统用户评论回复接口开发文档 ## 1\.概述 此文档供拥有技术能力数字人合作伙伴接入灵聚的NLP对话能力,是对直播数字人实现对话功能,如何接入灵聚的说明。灵聚可以支持数字人回复观众评论中的问题,也可以支持商家自定义对话内容。 ## 2\.接口调用流程图 接口调用流程见图:  ## 3\.授权认证接口 ### 灵聚开放平台 https://open\.lingju\.ai/ ### 授权认证API接口文档 [HTTP API接口文档](/project-2/doc-7/#h1-HTTPAPI接口文档) 开发者需要在灵聚开放平台注册账号,创建应用,应用类型选“标准接入——》HTTP”,创建好应用后把应用APPID给到灵聚开通服务器对接授权即可。深度合作伙伴亦可联系灵聚,由灵聚提供对应的参数。 ## 4\.评论回复接口 ### 接口路径 https://dev\.lingju\.ai/httpApi/commentChat\.do |名称|评论回复接口| |---|---| |\-|\-| |接口路径|https://dev\.lingju\.ai/httpApi/commentChat\.do| |请求方式|post| ### http post请求示例 ``` post https://dev.lingju.ai/httpApi/commentChat.do json格式串行化post上传,注意请求的header需添加 'Content-Type':'application/json;charset=UTF-8' { "appkey":"xxxxxxxxxxxxxxxxxxxxxx", "authcode":"xxxxxxxxxxxxxxxxxxxxxx", "userid":"xxxxxxxxxxxxxxxxxxxxxx", "data": [{ "name":"xxxxxx", "comment":"xxxxxx" }, { "name":"xxxxxx", "comment":"xxxxxx" }] } ``` ### 请求参数说明 |参数|数据类型|可需|描述| | |---|---|---|---|---| |appkey|String|必填|分配给开发者的专属appkey,请妥善保管| | |userid|String|必填|用户的userid| | |authcode|String|必填|给终端设备分配的授权码,由开发者自行管理| | |data|list|必填|评论集合| | | | | |name|评论用户名称| | | | |comment|评论内容| ### 接口返回JSON示例 ``` { "status": 0 , "userid":"xxxxxxxxxxxxxxxxxxxxxx", "content": [{ "name":"xxxxxxxxxxxxxxxxxxxxxx", "comment":"xxxxxxxxxxxxxxxxxxxxxx", "answer":"xxxxxxxxxxxxxxxxxxxxxx" }, { "name":"xxxxxxxxxxxxxxxxxxxxxx", "comment":"xxxxxxxxxxxxxxxxxxxxxx", "answer":"xxxxxxxxxxxxxxxxxxxxxx" }] } ``` ### 接口返回说明 ``` Content-Type:application/json;charset=UTF-8 ``` |属性名|数据类型|描述| | |---|---|---|---| |status|int|状态码,0=成功,表示收到弹幕、评论信息正在处理中,其它值则为错误码,请参考错误码表| | |description|String|通常为空,出错时会有错误信息| | |content|list|弹幕、评论集合| | | | |name|评论、用户名称| | | |comment|用户评论内容文本| | | |answer|灵聚回复文本\(格式与‘聊天对话控制接口’中的answer一致\)| ### 错误码表 |错误码|描述| |---|---| |\-|\-| |0|成功| |\-1|系统异常| |1|其它错误| |4|开发者帐号错误,账户未完成认证或已被禁用| |6|APPKEY无效| |7|model错误| |8|参数错误| |9|已经是最新版本| |10|重复操作| |11|授权码无效| |12|激活码重置过于频繁| |13|体验版授权码已过期| |14|激活失败,请重试| |15|连接中禁止切换用户| |16|终端未激活| |17|激活码已过期,请重置| |18|激活码无效| |19|会话过期| |20\-29|数据格式校验错误| |40|并发过高导致请求失败| |41|每次调用次数已达上限| |42|目标对象未同步,请先通过update接口更新后重试| |43|应用无效,已被限制使用| |44|应用无效,已废弃| |45|目标对象数量已达上限| |97|校验失败| |98|重复登录| |99|未登录| |111|参数错误| |114|帐号未认证| |120|账号已被禁用| |121|授权限额已满| |122|accessToken已过期| |123|没有调用http接口的权限| |124|系统应答超时| |129|应用已被限制| |989|该用户APPKEY非法| |990|总调用次数已达上限,请联系技术人员处理| |991|该终端用户不存在| |992|accessToken无效| |993|对话量异常,机器人需要休息一会,稍后再试| |996|对话太频繁了,暂时被禁用,稍后再试| ## 5\. 补充说明 此文档供拥有技术能力数字人合作伙伴接入灵聚的NLP对话能力,考虑了直播场景中的多种需求,但仍难免有疏漏之处,若合作伙伴有相关建议,可与灵聚联系,灵聚会继续完善接口设计。 - 点击添加[「灵聚开发者服务群」](/project-2/doc-5/) - 联系邮箱:ling@lingjutech\.com
lingju.ai
2026年10月20日 17:19
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码