知识管理更新知识

举报
云会议运营喵大人 发表于 2020/02/13 18:20:45 2020/02/13
【摘要】 更新知识接受文章信息,同步更新WeLink知识。此接口为同步接口,返回的信息是文章的ID。请求格式说明请求方式:PUT (HTTPS)请求地址:https://open.welink.huaweicloud.com/api/knowledge/v1/articles/update认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:U...

更新知识


接受文章信息,同步更新WeLink知识。

此接口为同步接口,返回的信息是文章的ID。

请求格式说明

请求方式:PUT (HTTPS)

请求地址:

https://open.welink.huaweicloud.com/api/knowledge/v1/articles/update

认证方式: access_token,请参考获取access_token

请求头部:

Accept-Charset:UTF-8
Content-Type:application/json
x-wlk-Authorization:access_token

请求参数:  

{
    "sourceArticleId":"id123",
    "sourceName":"example",
    "title":"标题示例",
    "contentType":1,
    "content":"内容示例",
    "link":"http://example.ex/",
    "lang":0,
    "isRecommended":1,
    "isTopped":0,
    "pubTime":1562633528,
    "coverImg":"http://example.ex/cover.jpg",
    "recDataStyle":1,
    "excerpt":"摘要示例",
    "cateName":"分类示例",
    "userId":"WeLink@tenant",
    "documents":"[{\"name\":\"text.doc\",\"url\":\"http://example.ex/abc.doc\"}]"
}

请求参数说明:  

参数参数类型必填说明
sourceArticleIdString当前来源识别文章的id【允许数字、字母、下划线,最大50个字符】
sourceNameString自定义来源识别字串【允许数字、字母、下划线,最大50个字符】
titleString标题【不传或为空表示不修改】
corpUserIdString作者在客户系统的登录标示,客户内唯一。corpUserId、userId都存在时优先使用corpUserId。【不传或为空表示不修改】
userIdString作者在WeLink中的用户账号【可在用户管理看到类似 xx@tenant 】。corpUserId、userId都存在时优先使用corpUserId。【不传或为空表示不修改】
contentTypeInteger类型【0:链接型,1:内容型,不传或为空表示不修改】
contentString内容【不传或为空表示不修改】
linkString链接型文章的链接【不传或为空表示不修改】
documentsArray附件信息。【不传或为空表示不修改】每个文件内容,name:文档完整名,包含后缀;size:文件大小,单位B;url:下载地址(支持无需鉴权的附件下载地址)。示例:[{"name":"文档名称.doc","size":"1024","url":"http://xxx.com/xxx.doc"}, {"name":"Excel文件名称.xls","size":"1024","url":"http://xxx.com/xxx.xls"}]
moduleTypeString文章模块【bulletins:信息发布文章,默认为bulletins】
langInteger语言【0:中文 1:英文,不传或为空表示不修改】
isRecommendedInteger是否推荐【0:否 1:是,不传或为空表示不修改】
isToppedInteger是否置顶【0:否 1:是,不传或为空表示不修改】
pubTimeLong发布时间,秒为单位的时间戳【不传或为空表示不修改】
coverImgString封面图URL【不传表示不修改,为空表示置空】
recDataStyleInteger条目模板【1:'左文右图',2:'大图卡',3:'视频(大)',4:'视频(小)',5:'直播',6:'音频',7:'博客',8:问答,9:文档式,不传或为空表示不修改】
excerptString摘要信息【不传表示不修改,为空表示置空】
cateNameString文章所属分类,【不传或为空表示不修改,传则取传过来的分类,没有则新建分类】

请求示例:  

curl -X PUT \
  'https://open.welink.huaweicloud.com/api/knowledge/v1/articles/update' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"sourceName":"example",    "sourceArticleId":"id123"}'

响应格式说明

返回结果:

正常返回结果:

{    "code": "0",    "data": {        "sourceArticleId" : "123456"
    }
}

异常返回结果:

{
    "code": "43011",
    "message": "parameter sourceArticleId is empty!"
}

返回参数说明:

参数必选参数类型说明
codeString数据正常返回“0”,如果发生错误,会返回对应的错误码。
messageString返回接口请求发生错误时的详细信息。正常情况无此信息
dataObject成功返回的数据
data.sourceArticleIdString成功的文章的sourceArticleId

错误码说明:

错误码说明
0成功
43021认证异常
43011参数错误
43012操作失败


【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。