资源共享开放接口
说明
1.公共参数:
<sitename>:表示数据分享平台域名,即 http://fs.nje.cn
2.调用地址:
<sitename>/Service/ShareResource.asmx
接口
1. 共享资源信息
调用方法:
public string Share(string sharesiteid,string encryptstring, string timespan, string uid, string title, string category, string size, string type, string link, string downLink, string tags, string comment, string user, string pubDate)
请求参数:
文字 说明
sharesiteid 站点编号
encryptstring sharesiteid+appkey+timespan+uid再进行MD5加密后的字符串(转换后字母都为小写),appkey由平台管理员分配)
timespan 时间参数(时间戳)。时间验证与服务器时间误差不得超过15分钟,以北京时间为准。
uid 资源唯一标识(该资源在站点数据库中保存的主键),长度200以内
title 资源标题,长度100以内
category 资源分类信息(该资源在站点中分类信息),长度50以内
size 资源文件大小,必须为大于0的长整数
type 资源文件类型(文件后缀名),长度20以内
link 资源访问地址,必须为链接地址格式,长度500以内
downLink 资源内容文件的真实下载地址,必须为链接地址格式,长度500以内
tags 资源标记信息,对资源内容的简短说明(关键字、标签),支持多个。单个长度8以内
comment 资源说明信息,长度200以内
user 统一身份认证平台用户名,长度100以内
pubDate 资源发布时间(时间精确到秒,例2015-01-26 17:02:02)
返回类型:
类型说明:
2. 移除共享资源信息
调用方法:
public string Remove(string sharesiteid, string encryptstring, string timespan, string uid)
请求参数:
属性 说明
sharesiteid 站点编号
encryptstring sharesiteid+appkey+timespan+uid再进行MD5加密后的字符串(转换后字母都为小写),appkey由平台管理员分配)
timespan 时间参数(时间戳)。时间验证与服务器时间误差不得超过15分钟,以北京时间为准。
uid 资源唯一标识(该资源在站点数据库中保存的主键),长度200以内
返回类型:
类型说明:
3. 获取站点共享资源
调用方法:
public PagedResult <string> PagedShareSiteResource(string sharesiteid, string encryptstring, string timespan, int pageindex, int pagesize, string starttime, string endtime,int type)
请求参数:
属性 说明
sharesiteid 站点编号
encryptstring sharesiteid+appkey+timespan再进行MD5加密后的字符串(转换后字母都为小写),appkey由平台管理员分配)
timespan 时间参数(时间戳)。时间验证与服务器时间误差不得超过15分钟,以北京时间为准。
pageindex 分页索引(从1开始)
pagesize 分页行数(从1开始,最大1000行)
starttime 开始时间(可为空,默认最小时间)
endtime 结束时间(可为空,默认最大时间)
type 检索范围【1当前站点2其它所有站点3所有站点】(可为空,默认当前站点)
返回类型:
类型说明:
属性 说明
ResultCode 返回结果,详细见【返回结果】
Models 资源信息列表
TotalCount 符合条件的教师总数
ShareResourceInfo:
属性 说明
Id 主键ID
ShareSiteID 站点编号
ResourceUID 资源唯一标识
Title 标题
Category 资源分类
Size 文件大小
Type 资源文件类型
Link 资源访问地址
DownLink 资源文件下载地址
Comment 资源说明
PublishUser 资源发布账户
PublishDate 资源发布时间
Tags 资源标签
接口相关算法(c#)
1. MD5
2. 时间戳
如:当前时间:2013/9/26 16:07:49 时间戳:1380182865
返回结果
编码 说明
ok 操作成功
101 缺少参数或者参数错误
102 共享站点不存在
103 资源已存在
104 资源不存在
105 资源惟一标识格式错误
106 资源标题格式错误
107 资源分类信息格式错误
108 资源文件大小格式错误
109 资源文件类型格式错误
110 资源访问地址格式错误
111 资源下载地址格式错误
112 资源比标签信息格式错误
113 资源发布账户格式错误
114 发布时间格式错误
115 加密字符串验证失败
116 请求超时
117 查询时间错误
400 发生异常
500 未知错误