2014年CALIS外文期刊网ODL接口说明_优秀文档.docVIP

CALIS外文期刊网 ODL接口集成说明 CALIS管理中心 2010年8月 目录 1概述 3 2 接口实现描述 3 2.1资源系统相关信息 3 2.1.1资源系统基本信息 3 2.1.2数据库相关信息 3 2.1.3 检索点的定义 4 2.2功能实现情况 4 3 Web服务JnlOdlService接口定义 6 3.1 Explain方法 6 3.2 GetList方法 10 3.3 GetDetail方法 13 4 Web服务ContentOdlService接口定义 16 4.1 Explain方法 16 4.2 GetList方法 20 4.3 GetDetail方法 23 5．数字签名生成规则 26 5.1说明： 26 5.2生成规则： 27 6．附件 27 6.1 Web服务OdlService的WSDL描述 27 6.2常用错误代码 33 1概述 本文档描述CALIS外文期刊网的对外数据服务接口（ODL）的调用方式、参数格式及相关参考实现。通过集成该接口，第三方应用平台可以从后台获取CALIS外文期刊网的期刊及文章篇目数据及全文链接和相关馆藏信息，对第三方应用平台的用户来说，与检索第三方应用平台本地资源的体验是完全相同的。 CALIS外文期刊网对外数据服务接口（ODL）基于SOAP协议开发，可以集成于各种应用平台中。该接口服务需通过CALIS的安全验证， CALIS分发的密钥作为请求服务时的参数之一，只有通过验证的请求才可以获取该服务。 2 接口实现描述 2.1资源系统相关信息 2.1.1资源系统基本信息 资源系统名称：CALIS外文期刊网 所含数据库列表： 数据库名称 是否为默认数据库 备注 CALIS外文期刊数据库 是 用于期刊检索服务 CALIS外文期刊篇目数据库 是 用于篇目检索服务 2.1.2数据库相关信息 数据库名称：CALIS外文期刊数据库 数据项 取值 备注 数据库已有记录数 94540 可返回数 1000 支持的语种 多语种 是否含全文链接 否 所含的子库 无 所属分类 期刊 数据库名称：CALIS外文期刊篇目数据库 数据项 取值 备注 数据库已有记录数 3400万 可返回数 1000 支持的语种 多语种 是否含全文链接 否 所含的子库 无 所属分类 期刊 说明：若包含多个数据库，则重复填写以上表格。 2.1.3 检索点的定义 数据库名称：CALIS外文期刊数据库 检索点中文名 检索点标识 备注 期刊名称 journaltitle Issn issn 学科 subject 学科中文名称 数据库名称：CALIS外文期刊篇目数据库 检索点中文名 检索点标识 备注 题名 articletitle 作者 author 期刊名称 journaltitle 出版年 pyear 格式为四位数字(yyyy) 所属卷 volume 所属期 issue 全面检索 all 同时检索题名、作者及期刊名称 2.2功能实现情况 功能 默认(√) 是否支持 备注 查询条件 个数 1项 √ 支持 2项 √ 支持 3项 √ 支持 匹配关系 包含 √ 支持 前方一致 √ 支持 精确匹配 √ 支持 逻辑关系 与 √ 支持 或 √ 支持 非 √ 支持 时间限定 年月 (yyyy-mm) － 不支持 年 (yyyy) － 支持 对于“年(yyyy)”： 当查询请求时间为yyyy-mm时，该系统能在内部取出“年”进行查询 － 支持 排序方式 时间排序(逆序) √ 支持 篇目检索服务不支持时间排序 相关度排序 √ 支持 记录集 记录集标识 － 不支持 记录集翻页 － 支持 明细信息 获取方式 返回明细信息 － 支持 返回明细页面链接 － 不支持 Detailid格式/示例 － － 10269259700 详细记录URL示例 － － 全文链接 全文链接 － 支持 错误代码 错误代码 － 支持 详见“4.3节” 3 Web服务JnlOdlService接口定义 资源系统对外提供的期刊检索web服务为JnlOdlService，它包含以下三个方法： Explain GetList GetDetail 本节给出上述三个方法的详细定义。 3.1 Explain方法 方法名称：explain 功能：返回Web服务（GetList和GetDetail）中有关元数据、数据库、子库的定义和说明 参数：无 返回值：ExplainData对象 【ExplainData对象说明】 ExplainData Name CALIS外文期刊系统