版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

背景说明:

兔展支持通过api接口实现作品的管理

功能详情:

1、获取作品列表

使用说明:通过该接口可以获取当前账号下的作品信息,支持租户模式下跨企业查询

兔展作品列表:

Image Added

接口协议:HTTPS

HTTP请求方式:GET

请求参数

参数
必选
类型
说明
companyId
false
string
第三方平台的企业id,如果没有则不必传,有则传,其他接口必须保持一致

uid
true
string
第三方平台的用户id
queryTypefalseinteger查询类型 1:查询企业所有的; 0:查询当前用户有数据权限的;默认0 如果查询企业所有的,则当前用户必须是超管角色。非超管角色返回空
keyword
false
string
作品名称
pageNo
false
integer
页码,从1开始的正整数
pageSize
false
integer
每页数量,从1开始的正整数

返回参数

参数类型说明
idstring作品id
namestring作品名称
imgurlstring作品图片地址
appurlstring作品地址(当作品存在 助力、组队、拼团的玩法时需要配置自定义域名,否则不展示appurl)

orgDomain

string作品自定义域名,有则返回,无则不返回
formcountinteger表单数据
statestring作品状态 1:正常;2:封禁;3:白名单;4:可疑,危险的作品
descstring作品描述
appTItlestring作品标题
appTypestring作品类型,1:玩法作品;2:H5作品;3:视频作品
appVersionstring作品版本
createTImelong创建时间
updateTimelong修改时间

2、根据作品ids获取作品信息

使用说明:通过该接口可以根据当前uid账号下的作品id,查询作品详情,支持租户模式下跨企业查询

兔展作品列表:

接口协议:HTTPS

HTTP请求方式:GET

请求参数

参数
必选
类型
说明
companyId
false
string
第三方平台的企业id,如果没有则不必传,有则传,其他接口必须保持一致
uid
true
string
第三方平台的用户id
ids
true
string
兔展作品id,多个以‘,’分隔

返回参数

参数类型说明
idstring作品id。规则uuid,长度64个字符
namestring作品名称
imgurlstring作品图片地址
appurlstring作品地址(当作品存在 助力、组队、拼团的玩法时需要配置自定义域名,否则不展示appurl)

orgDomain

string作品自定义域名,有则返回,无则不返回。(配置了自定义域名,则appurl字段值==orgDomain字段值)
formcountinteger表单数量
audienceCountinteger客户数量
statestring作品状态 1:正常;2:封禁;3:白名单;4:可疑的,危险的作品
appStatusString视频渲染状态:1:正常; 0:新建(未发布); 2:封禁; 3:白名单 4:可疑的、危险的作品 5:已审核 6:转移作品,可疑封禁 7:关闭作品 8:广告作品 9:鸡汤作品 101:转换中 102:转换完成 103:PPT转换失败 104:PPT转换超时 105:系统封禁 111:人工正常 112:机器封禁 212:未上线(腾讯云) 201:作品下线
descstring作品描述
appTItlestring作品标题
appTypeString作品类型: 1:兔展作品,2:长页作品
appVersionstring作品版本
createTImelong创建时间
updateTimelong修改时间
pluginInfoVosList<Object>玩法信息
└─componentIdString组件Id
└─componentNameString玩法名称。比如 抽奖
└─pluginNameString玩法名称。比如 Lottery
└─deletedinteger删除标识。 1-已删除,0-未删除
└─startTimeDate玩法开始时间
└─endTimeDate玩法结束时间


3、作品分享设置

使用说明:通过该接口可以修改当前账号下的作品信息,比如作品名称、作品描述、作品封面。

兔展分享设置:

Image Added

接口协议:HTTPS

HTTP请求方式:POST

请求参数

参数
必选
类型
说明
companyId
false
string
第三方平台的企业id,如果没有则不必传,有则传,其他接口必须保持一致
uid
true
string
第三方平台的用户id
appid
true
string
作品id
shareTitle
true
string
分享标题
shareDesc
true
string
分享描述
shareImg
true
string
分享图片url
showViewFlag
true
integer
是否显示阅读数,0:不显示;1:显示
settingsfalsestring

高级功能设置,json格式字符串。

示例

{
    "workbench":{
        "wxAuthMode":"3"
    }
}

示例说明

enum AUTH_MODE {
  /** 明文授权 */
  SNSAPI_USERINFO = '0',
  /** 静默授权 */
  SNSAPI_BASE = '1',
  /** 先静默后明文授权 */
  SNSAPI_BOTH = '2',
  /** 强制明文授权 */
  FORCE_SNSAPI_USERINFO = '3',
}

返回参数

参数类型说明
codestring请求结果:200 成功,其他则为失败
errorCodestring请求结果信息:SUCCESS 成功,其他则为失败
msgstring操作返回信息
databoolean操作结果:true:成功

4、删除作品

5、作品封禁

6、复制作品

7、作品上下线

8、获取作品海报二维码信息

9、获取作品封面

10、获取作品的玩法