21.2.      REST检索API

CSpace提供了REST检索API支持与外部系统的数据交换。此接口根据授权用户发送的请求检索表达式,返回IR系统中知识产出元数据,格式为XMLJSON

(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)           返回数据类型

此接口目前提供xmljson两种返回值类型。通过Ajax提交检索请求时,设置dataType值为jsonxml,即可返回jsonxml类型数据。不设置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地址”。