# 获取展品授权信息 (响应类型:授权结果/展品信息/资源信息/文件流)

# 调用方式: GET

# 接口地址:

url1: https://api.freelog.com/v2/auths/presentables/{presentableId}/{result|info|resourceInfo|fileStream}
url2: https://api.freelog.com/v2/auths/presentables/nodes/{nodeId}/{resourceIdOrName}/{result|info|resourceInfo|fileStream}
1
2

# url1传入参数说明:

参数 必选 类型及范围 说明
presentableId 必选 string 展品Id
parentNid 可选 string 依赖树上的父级节点ID,一般获取展品子依赖需要传递
subResourceIdOrName 可选 string 子依赖的资源ID或者名称
subResourceFile 可选 string 主题或插件的压缩包内部子资源,需要带相对路径

# url2传入参数说明:(resourceId,resourceName,presentableName必选其一)

参数 必选 类型及范围 说明
nodeId 必选 int 节点ID
resourceIdOrName 必选 string 资源ID或者名称,需要encodeURIComponent编码
parentNid 可选 string 依赖树上的父级节点ID,一般获取展品子依赖需要传递
subResourceIdOrName 可选 string 子依赖的资源ID或者名称
subResourceFile 可选 string 主题或插件的压缩包内部子资源,需要带相对路径

# 返回说明: 公共http-header返回说明:

返回值字段 字段类型 字段说明
freelog-entity-nid string 当前响应的展品的依赖树链路ID
freelog-presentable-id string 展品ID
freelog-presentable-name string 展品名称,encodeURIComponent编码
freelog-sub-dependencies string 当前展品的子依赖,encodeURIComponent编码的json字符串
freelog-resource-type string 资源类型
freelog-resource-property string 资源meta信息,encodeURIComponent编码过的json字符串

# response-type: result (标准授权响应结果)

返回值字段 字段类型 字段说明
subjectType int 标的物类型
referee int 标的物服务类型ID
defaulterIdentityType int 授权不通过责任方(1:资源 2:节点 4:消费者 128:未知). 多个违约方会通过|运算符计算,注意区分
authCode int 授权码
isAuth bool 是否授权通过
data object 附加数据,例如授权失败的资源
errorMsg string 授权错误提示

# response-type: info (展品信息)

返回值字段 字段类型 字段说明
presentableId string 展示方案ID
presentableName string 展示方案名称,节点内唯一
presentableTitle string 展示方案标题,用于展示
tags string[] 用户定义的tags
intro string presentable简介
onlineStatus int 上线状态 0:下线 1:上线
userId int 创建方案的用户ID
nodeId int 节点ID
resolveResources object[] 资源以及其上抛的解决方式
** resourceId string 解决的资源ID
** resourceName string 解决的资源名称
** contracts object[] 解决的资源的策略
**** policyId string 选中的策略ID
**** contractId string 策略生成的合约ID
policies object[] 对外授权的策略组
** policyId string 策略ID
** policyName string 策略名称
** status int 策略状态 0:下线(未启用) 1:上线(启用)
resourceInfo object presentable引用的资源基础信息
** resourceId string 资源ID
** resourceName string 资源名称
** resourceType string 资源类型
version string 展品的版本,同引用的资源版本号
createDate date 创建日期

# response-type: resourceInfo (资源信息)

返回值字段 字段类型 字段说明
resourceId string 资源ID
resourceType string 资源类型
resourceName string 资源名称
userId int 用户ID
username string 用户姓名
coverImages string[] 封面图片
intro string 资源简介
tags string[] 资源标签集
latestVersion string 资源最大版本号
resourceVersions object[] 资源版本信息
** version string 资源版本号
** versionId string 资源版本Id
** createDate date 版本创建时间
policies object[] 资源授权策略
baseUpcastResources object[] 基础上抛信息
** resourceId string 上抛资源ID
** resourceName string 上抛资源名称

# response-type: fileStream (文件流)

标准 fileStream 文件流

# 授权失败时统一响应(非 response-type: result)

返回值字段 字段类型 字段说明
ret int 公共标准响应结果
errcode int 3:授权失败错误
data object 具体的授权信息
** subjectType int 标的物类型
** referee int 标的物服务类型ID
** breachResponsibilityType int 授权未通过的责任主体类型: 1:资源方 2:节点方 4:C端用户 128:无
** authCode int 授权码
** isAuth bool 是否授权通过
** data object 附加数据,例如授权失败的资源
** errorMsg string 授权错误提示