畅言社会化评论系统社交评论插件开发.docxVIP

畅言社会化评论系统技术文档Web网站接入指南概述畅言提供了多种接入方式，开发者可以按需选择：使用JS嵌入的方式；直接调用畅言开放API接口的方式多种接入方式1、JS嵌入流程注册完成后出现如下图界面JS代码嵌入JS代码嵌入是最简易的网站接入方式。将生成的JS代码复制并粘贴到您网页需要的地方；如果您的网站使用的模板，您也可以复制代码到您的模板中，社会化评论框将在所有网页自动出现，此时您就可以轻松获取畅言服务！2、API接口调用除了使用JS代码嵌入方式外，您还可以通过调用畅言平台的API接口，获得更深度的定制。具体的API调用方式及接口说明文档，请参考?开放平台-API开放接口。注意：当您使用JS嵌入的方式来生成评论框，但是文章没有唯一URL地址时，或者对于同一篇文章有多页展示，但是需要显示的是相同的评论内容时，可以配置source id来区分文章（即文章的id）。具体如何配置，请参考?高级开发-自定义配置自定义配置概述在插入通用代码时，可以增加一些参数，来实现自定义的功能配置source id当您使用JS嵌入的方式来生成评论框，但是文章没有唯一URL地址时，或者对于同一篇文章有多页展示，但是需要显示的是相同的评论内容时，可以配置source id来区分文章（即文章的id）。“#source id#是您需要配置的部分，如下图配置owner id当您需要使用删除通知接口时，需要先配置owner id（即文章所有者的id）。“#owner id#是您需要配置的部分，如下图发布者删除评论概述对于UGC（如博客等）类网站，当内容发布者发布的内容被评论，但是却想要删除此评论时，畅言提供了以下解决方案。在使用前请先配置owner id。具体如何配置，请参考?高级开发-自定义配置发布者删除评论1、删除评论流程图如下2、验证接口（需要您提供）描述：用于验证当前登录用户是否为内容发布者URL：?点击到后台设置中填写请求方式：GET请求参数：参数名类型是否必须说明owner_idStringY内容所有者ID-由您提供topic_urlStringN当前页面的URL，和topic_source_id二选其一topic_source_idStringN内容ID，和topic_url二选其一-由您提供返回：JSON格式字段名类型说明ownerint有无删除评论的权限（1：有权限，0：无权限）代码样式{ owner: 1}3、验证删除信息接口（需要您提供）描述：验证前端发起的删除请求是否内容所有者发起URL：?点击到后台设置中填写请求方式：POST请求参数：参数名类型是否必须说明client_idStringYAPP ID-由畅言供owner_idStringY内容所有者ID-由您提供topic_idStringY新闻ID—畅言IDcomment_idStringY评论ID—畅言IDtopic_urlStringN当前页面的URL，和topic_source_id二选其一topic_source_idStringN文章ID，和topic_url二选其一-由您提供返回：JSON格式字段名类型说明successint是否删除成功（1：删除成功，0：删除失败）代码样式{ success: 1}4、删除评论接口（畅言提供）描述：验证通过后，调用畅言删除接口URL：/api/open/ugc/comment/delete请求方式：POST请求参数：参数名类型是否必须说明client_idStringYAPP ID-由畅言供owner_idStringY内容所有者ID-由您提供topic_idStringY新闻ID—畅言IDcomment_idStringY评论ID—畅言IDsignStringY签名方式为按照所有参数（除sign参数外）的字典顺序即name=value的形式以符号链接起来，然后使用HmacSha1方式以client_secret作为密钥进行签名返回。返回：如果成功返回空，失败返回错误信息。（JSON格式）字段名类型说明error_codeString错误码error_msgString错误信息发布者获取新评论概述对于UGC（如博客等）类网站，当内容发布者想获得发布的内容的新评论列表时，畅言提供了以下解决方案。在使用前请先配置owner id。具体如何配置，请参考?高级开发-自定义配置发布者获取新评论1、获得新评论接口描述：获取内容所有者的最新评论列表URL：/api/open/ugc/comment/list请求方式：GET请求参数：参数名类型是否必须说明client_idStringYAPP ID-由畅言供owner_idStringY内容所有者ID-由您提供page_nointN页数page_sizeintN每页条数callbackStrin