CSpace提供了REST检索API支持与外部系统的数据交换。此接口根据授权用户发送的请求检索表达式,返回IR系统中知识产出元数据,格式为XML或JSON。
(1) 请求地址
请求地址格式如下:
http://[IR_domain_name]/api/search
调用示例:
http://210.77.64.221:8080/api/search?query=TY=期刊论文&start_date=2014-01-01&end_date=2015-01-26&order_by=year&order=desc&size=10&offset=0
(2) 接口参数说明
参数名称 |
参数类型 |
是否必须 |
默认值 |
参数描述 |
query |
string |
true |
无 |
检索表达式 l 检索字段:TI(题名),AU(作者),TY(作品类型,可选值为:期刊论文、会议论文、专著、专利),PY(发表时间)等等。其他检索字段和检索表达式具体说明详见 信息检索—高级检索—专业检索。 |
start_date |
string |
false |
无 |
起始日期(出版日期),格式:yyyy-MM-dd |
end_date |
string |
false |
无 |
截至日期(出版日期),格式:yyyy-MM-dd |
order_by |
string |
false |
year |
排序字段: l title l year |
order |
string |
false |
desc |
排序方式: l asc l desc |
size |
integer |
false |
10 |
一次查询返回条目数,参数大于100时返回100条。 |
offset |
integer |
false |
0 |
提取结果在查询结果集中的起始位置。 |
(3) 返回值
返回值字段 |
字段类型 |
字段说明 |
itemsCount |
integer |
当前返回条目数 |
totalResults |
integer |
符合检索条件的条目总数 |
offset |
integer |
提取结果在查询结果集中的起始位置 |
error_message |
string |
查询失败时的错误信息: l “查询表达式不能为空”:参数query不能为空; l “查询表达式有误”:参数query格式有问题,请按照“检索表达式说明”拼写表达式; l “查询表达式有误,TY可选值为:期刊论文、会议论文、专著、专利”:参数query中的TY字段只能选择期刊论文、会议论文、专著或专利。 |
item |
array |
返回条目元数据: identifier – 条目本地handle doi – 作品DOI type – 文献类型 creator – 作者 publisher – 出版者 title – 题名 publicationTitle – 期刊名称 placeOfPublication – 出版地 date – 出版/发表日期(专利的公开/告日期) volume – 卷号 issue – 期号 pages – 页码 version – 版本(专著的版本) patentNumber – 专利号 editor – 编者(会议录的编者) keyword – 关键词 abstractCN – 中文摘要 abstractEN – 英文摘要 |
(4) 返回数据类型
此接口目前提供xml和json两种返回值类型。通过Ajax提交检索请求时,设置dataType值为json或xml,即可返回json或xml类型数据。不设置dataType时默认返回xml类型。若直接使用HTTP调用,请将HTTP Header中的Accept值改为application/xml,或application/json。
a) xml格式数据示例
<items> <itemsCount>2</itemsCount> <totalResults>33</totalResults> <offset>0</offset> <error_message/> <item> <identifier>http://ir.licp.ac.cn/handle/362003/4847</identifier> <doi/> <type>会议论文</type> <creator>梁晓静;刘淑娟;王帅;蒋生祥</creator> <publisher/> <title>层自组装层自组装氧化石墨烯/硅胶核-壳型色谱填料研究</title> <publicationTitle>第19届全国色谱学术报告会及仪器展览会论文集</publicationTitle> <placeOfPublication/> <date>2013-03</date> <volume/> <issue/> <pages>226-228</pages> <version/> <patentNumber/> <editor/> <keyword>氧化石墨烯;层层自组装;氧化石墨烯/硅胶;液相色谱填料</keyword> <abstractCN/> <abstractEN/> </item> <item> <identifier>http://ir.licp.ac.cn/handle/362003/5039</identifier> <doi/> <type>期刊论文</type> <creator>肖乾;穆明;周新建;梁军</creator> <publisher/> <title>高速列车轮轨材料滑动摩擦实验研究</title> <publicationTitle>华东交通大学学报</publicationTitle> <placeOfPublication/> <date>2013</date> <volume>30</volume> <issue>5</issue> <pages>24-29</pages> <version/> <patentNumber/> <editor/> <keyword> 滑动摩擦;摩擦系数;高速列车;轮轨材料;Sliding friction;frictioncoefficient;high-speedtrains;wheel-rail material </keyword> <abstractCN> 在高速列车实际运行中,轮轨之间会发生剧烈摩擦。轮轨之间的摩擦不仅存在滚动摩擦运动,也存在相对横向和径向滑动摩擦运动,特别在小曲线弯道时不能忽视滑动摩擦产生的破坏作用。文章以动车轮轨材料LM1奥贝体钢为摩擦试验样块做研究对象,使用往复式球-盘试验机通过考察不同条件下的滑动摩擦实验研究,进行了不同载荷,不同温度,不同滑动速度下的轮轨材料摩擦实验,然后使用扫描电子显微镜(SEM),非接触三维表面轮廓仪(3D-MAP),X 射线衍射(XRD),X 射线光电子能谱(XPS)等实验表征设备来解释摩擦机理。 </abstractCN> <abstractEN/> </item> </items> |
b) json格式数据示例
{ "items": { "itemsCount": 2, "totalResults": 33, "offset": 0, "error_message": "", "item": [ { "identifier": "http://ir.licp.ac.cn/handle/362003/4847", "doi": "", "type": "会议论文", "creator": "梁晓静;刘淑娟;王帅;蒋生祥", "publisher": "", "title": "层自组装层自组装氧化石墨烯/硅胶核-壳型色谱填料研究", "publicationTitle": "第19届全国色谱学术报告会及仪器展览会论文集", "placeOfPublication": "", "date": "2013-03", "volume": "", "issue": "", "pages": "226-228", "version": "", "patentNumber": "", "editor": "", "keyword": "氧化石墨烯;层层自组装;氧化石墨烯/硅胶;液相色谱填料", "abstractCN": "", "abstractEN": "" }, { "identifier": "http://ir.licp.ac.cn/handle/362003/5039", "doi": "", "type": "期刊论文", "creator": "肖乾;穆明;周新建;梁军", "publisher": "", "title": "高速列车轮轨材料滑动摩擦实验研究", "publicationTitle": "华东交通大学学报", "placeOfPublication": "", "date": 2013, "volume": 30, "issue": 5, "pages": "24-29", "version": "", "patentNumber": "", "editor": "", "keyword": "滑动摩擦;摩擦系数;高速列车;轮轨材料;Sliding friction;frictioncoefficient;high-speedtrains;wheel-rail material", "abstractCN": "在高速列车实际运行中,轮轨之间会发生剧烈摩擦。轮轨之间的摩擦不仅存在滚动摩擦运动,也存在相对横向和径向滑动摩擦运动,特别在小曲线弯道时不能忽视滑动摩擦产生的破坏作用。文章以动车轮轨材料LM1奥贝体钢为摩擦试验样块做研究对象,使用往复式球-盘试验机通过考察不同条件下的滑动摩擦实验研究,进行了不同载荷,不同温度,不同滑动速度下的轮轨材料摩擦实验,然后使用扫描电子显微镜(SEM),非接触三维表面轮廓仪(3D-MAP),X 射线衍射(XRD),X 射线光电子能谱(XPS)等实验表征设备来解释摩擦机理。", "abstractEN": "" } ] } } |
(5) 权限控制
此接口目前使用IP进行权限控制,请根据调用方的申请,在系统管理控制区“系统配置—参数配置”页面,添加调用方的“API接口授权IP地址”。