探索我们的工具和web服务,并学习如何将它们包含在您的应用程序中

更多信息

内容服务构成了一个简单的API提供对Reactome知识库的访问。Reactome的信息由生物学专家撰写,由Reactome编辑人员维护,并广泛交叉引用其他资源,如NCBI, Ensembl, UniProt, UCSC Genome Browser, HapMap, KEGG(基因和化合物),ChEBI, PubMed和GO。它还包含推断的同源反应超过20个非人类物种,包括小鼠,大鼠,鸡,河豚鱼,蠕虫,苍蝇,酵母,大米,拟南芥和大肠杆菌。此外,内容服务提供了从PSICQUIC集成的分子交互访问。

内容服务基于具象状态传输(Representational State Transfer, REST)协议。这消除了对复杂客户机的需求,并使服务更简单、更轻量级、更灵活,因此,与SOAP/WSDL对应的服务相比,更容易集成到第三方软件中。

API包括一组根据功能分组的方法。例如,扩大路径组揭示了一组方法,这些方法提供了关于路径的特定信息,如所包含的Events或参与的PhysicalEntities。所有方法都指定为GET或POST请求。GET和POST是不可互换的。展开特定的方法提供有关其输入和输出参数的更多信息,以及供用户尝试的简单测试用例。此外,用户还可以使用任何命令行客户端,如wget旋度访问方法。

值得一提的是,为了有效地使用这个API,用户需要了解Reactome数据模型模式

开始

让我们从一个最基本的例子开始;检索数据库的版本。可以通过查询“/data/database/version”方法来解决:

curl -X GET——header 'Accept: text/plain' '//www.joaskin.com/ContentService/data/database/version'

响应将是一个“文本/普通”文件,只包含发布的编号。

检索反应的信息Mad1结合着丝粒标识符是r - hsa - 141409,查询如下:

curl -X GET——header 'Accept: application/json' '//www.joaskin.com/ContentService/data/query/R-HSA-141409'

响应的格式为“application/json”:

{dbId: 141409, displayName: "Mad1 binding kinetochore", stId: "R-HSA-141409", created: {dbId: 143430, displayName: "Yen, T, 2004-05-05 00:00:00", dateTime: "2004-05-05 05:00:00.0", schemaClass: "InstanceEdit"}, modified: {dbId: 1591212, displayName: "Matthews, L, 2011-09-08", dateTime: "2011-09-08 21:45:40.0", schemaClass:"InstanceEdit"}, isInDisease: false, isInferred: false, name: ["Mad1 binding kinetochore"], speciesName: "Homo sapiens", author: [143430], compartment: [{dbId: 70101, displayName: "cytosol", accession: "0005829", databaseName: "GO",定义:“细胞质中不包含细胞器但包含其他颗粒物质的部分,如蛋白质复合物。”,名称:"cytosol", url: "http://www.ebi.ac.uk/ego/QuickGO?mode=display&entry=GO:0005829", schemaClass: "EntityCompartment"}],文献参考:[{dbId: 143441, displayName:“有丝分裂检查点蛋白HsMAD1和HsMAD2与间期的核孔复合物相关”,标题:“有丝分裂检查点蛋白HsMAD1和HsMAD2与间期的核孔复合物相关”,期刊:“J Cell Sci”,页数:“953-63”,pubMedIdentifier: 11181178,卷:114,年:2001,网址:"http://www.ncbi.nlm.nih.gov/pubmed/11181178", schemaClass: "LiteratureReference"}], species: [{dbId: 48887, displayName: "Homo sapiens", name: ["Homo sapiens", "H. sapiens", "Hs", "human", "man"], taxId: "9606", schemaClass: " species "}], summary: [{dbId: 143355, displayName: ""], text:“Mad1协会与着丝粒是第一步Mad2介导信号放大的过程中从有缺陷的着丝粒。”,schemaClass:“求和”}),输入:[{dbId: 141433年,displayName:“MAD1L1(胞质)”,他说:“r - hsa - 141433”,名字:“MAD1L1”、“HsMad1”,speciesName:“智人”,consumedByEvent:[141409], endCoordinate: 718, referenceType: "ReferenceGeneProduct", startCoordinate: 1, schemaClass: " entitywithaccessionsequence "}, {dbId: 141398, displayName: "Kinetochore Complex [cytosol]", stId: "R-HSA-141398", name: ["Kinetochore Complex"], specesname: "Homo sapiens", consumedByEvent: [141409], schemaClass:"GenomeEncodedEntity"}],输出:[{dbId: 141441, displayName: "Mad1:动粒载体复合物[cytosol]", stId: "R-HSA-141441", name: ["Mad1:动粒载体复合物"],speciesName: "Homo sapiens", producedByEvent: [141409], hasComponent: [], schemaClass: " complex"}, schemaClass: "Reaction"}

在前面的结果中,有几个json字段键,如dbId、displayName、stId、name、compartment、literatureReference等。如果我们只对特定字段感兴趣,例如隔间,查询将如下所示:

curl -X GET——header 'Accept: text/plain' '//www.joaskin.com/ContentService/data/query/R-HSA-141409/compartment'

在这种情况下,因为是一个对象,结果将是一个TSV文件,其中第一列是对象的标识符,第二列是对象的displayName,第三列是对象的schemaClass:

70101细胞溶质EntityCompartment

如果查询的属性是原始的类型:

curl -X GET——header 'Accept: text/plain' '//www.joaskin.com/ContentService/data/query/R-HSA-141409/displayName'

然后返回的值是它在一个“文本/普通”响应中的内容:

Mad1结合着丝粒

作为本节的最后一个例子,让我们看看如何检索前面例子中使用的反应的参与分子。为此,我们调用getParticipatingPhysicalEntities方法:

curl -X GET——header 'Accept: application/json' '//www.joaskin.com/ContentService/data/event/R-HSA-141409/participatingPhysicalEntities'

响应的格式为“application/json”:

[{dbId: 141398, displayName: "Kinetochore Complex [cytosol]", stId: "R-HSA-141398", name: ["Kinetochore Complex"], speciesName: "Homo sapiens", schemaClass: "GenomeEncodedEntity"}, {dbId: 141433, displayName: "MAD1L1 [cytosol]", stId: "R-HSA-141433", name: ["MAD1L1", "HsMad1"], speciesName: "Homo sapiens", endCoordinate:718, referenceType: "ReferenceGeneProduct", startCoordinate: 1, schemaClass: "EntityWithAccessionedSequence"}, {dbId: 141441, displayName: "Mad1:kinetochore complex [cytosol]", stId: "R-HSA-141441", name: ["Mad1:kinetochore complex"], speciesName: "Homo sapiens", hasComponent: [], schemaClass: " complex"}]

检查ContentService API找出更多的方法,看看哪些方法能满足你的需要。请此电子邮件地址正受到垃圾邮件程序的保护。您需要启用JavaScript才能查看它。如果您的需求没有得到满足,并且您认为应该在我们的API中添加额外的方法。

资源

API文档

图出口国