此网站需要Cookie，并且您的个人数据才能发挥作用。通过使用您同意的网站按照我们的隐私声明和cookie策略.

授予RESTful（Grist）API

Grist数据库包含由欧洲PMC出资人.

请参见Grist中使用的数据字段的说明。

使用此API搜索Grist数据库。

加入欧洲PMC网络服务用户的谷歌群接收有关即将发布的web服务的通知，以及变化。

我们建议您在使用此API之前阅读我们的隐私声明。由使用我们的公共API，您同意接受欧洲PMC网站隐私声明.

统一资源定位地址语法

为搜索请求构造URL，如下所示：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query={}[&参数]

请求参数

查询

使用此参数输入搜索词。[注意，这是唯一的必需参数。]

您可以使用关键字或关键字组合；用于定义关于关键字搜索，请参见Grist API参数

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=cluster
https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=集群随机化的

或一个带有括语标记的短语：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=“随机分组”

或现场搜索；有关可用搜索字段的列表，请参见Grist API参数

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=pi:smith
https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=title:“群集”
https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=ga：“英国癌症研究”
https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=ga：“BHF”pi:史密斯

注：

查询中的单独搜索词应使用空格分隔，不是&号，所有这些搜索词都与逻辑AND。如果未给定特定字段（例如，pi:、ga:、gr:）对于搜索词，默认使用关键字（kw:）搜索。

因此，例如，以下查询将无法识别授权人名为“史密斯”，由威康信托基金资助：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=ga：“威康信托”&pi:smith

因为它相当于这个关键字搜索：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=ga：“威康信托”kw:&pi:smith

在这种情况下，正确的查询应该是：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=ga：“威康信托”pi:smith

结果类型

结果类型可以是清淡的[默认值，如果参数未指定]或核心:

  • 清淡的返回给定搜索词的关键元数据；
  • 核心返回给定搜索词的完整元数据，包括摘要、拨款开始/结束日期和机构详细信息。

例如：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=gid:081052&resultType=core

第页

所需结果页面的编号。每个页面都包含结果最多25次授权，页码从1开始[默认值如果参数未指定]。

例如：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=mallage&page=4

格式

格式可以是XML格式[如果参数未指定，则为默认值]或JSON格式或CERIF公司.

例如：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=mallage&format=json
https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=mallage&format=cerif

Grist API参数

[请参阅Grist中使用的数据字段的说明].

语法词描述例子
ga，授权代理在出资人姓名/缩写中搜索术语/基金参考号ID。[查看Grist中使用的出资人姓名列表.]ga：“Wellcome Trust”，ga：BBSRC，授权代理：501100000381
gid，gr，授予id在授权编号/ID中搜索术语。全球数字：083611
标题，ti在授予标题中搜索一个或多个术语。标题：癌症，ti：“肾癌”
抽象，abs在拨款摘要中搜索一个或多个术语。文摘：“多样化功能”
日期，活动日期按活动日期搜索，其中给定的日期介于开始和结束之间日期。格式必须按yyyy-mm-dd，其中月（mm）和日（dd）是可选的。日期：2011-02-12，日期：2012-04，活动日期：2010
千瓦在授予标题、摘要、流和类型。kw：“生理科学”
圆周率按姓氏和可选首字母搜索PI。pi：哈伯德，pi：“哈伯德S”
pi_id，作者_id通过替代标识符搜索PI，例如ORCID。格式必须是{id类型}/{id值}pi_id：ORCID/0000-0001-2345-6789
空军在机构名称/部门中搜索一个或多个术语。aff:剑桥，aff:“曼彻斯特大学”，aff：“生命科学”
猫搜索赠款的类别分组。可以关联拨款具有多个类别。猫：“COVID-19”
epmc_funders（epmc_founder）搜索属于欧洲PMC出资人集团的出资人。接受的值为：yes|no、y|n和true|false。epmc_funder：是

CERIF公司美国石油学会

请参阅CERIF XML架构有关响应实体的详细信息。

分页工作原理

分页资源默认限制为25个授予，页面编号从1开始[如果参数未指定，则为默认值]。分页详细信息包含在HTTP响应头中。

例如：

https://www.ebi.ac.uk/europepmc/GristAPI/rest/get/query=pi:smith&format=cerif&page=2

对于下面显示的链接头值上方的搜索：

HTTP/1.1 200正常
服务器：Apache-Coyote/1.1
点击次数：407
结果类型：CERIF
查询：pi:smith
页码：第2页
内容类型：text/xml
传输编码：分块

点击次数

定义记录总数的整数：在编写上述搜索返回整数：407。