对网站和网页的认识,国外免费注册域名的网站,仿淘宝网站模板,石家庄新钥匙做网站API
API 这个词在大多数人看来可能和 CNS 差不多#xff0c;前者天天听说就是用不上#xff0c;后者天天读就是发不了。
不过#xff0c;通过今天的一个简短介绍#xff0c;今后 API 这个东西你就用上了#xff0c;因为在文章最后我将会展示一个最最基础且高频的 API 使… API
API 这个词在大多数人看来可能和 CNS 差不多前者天天听说就是用不上后者天天读就是发不了。
不过通过今天的一个简短介绍今后 API 这个东西你就用上了因为在文章最后我将会展示一个最最基础且高频的 API 使用示例。
所谓 API(Application Programming Interface) 就是应用程序接口。这个应用程序可以类比于手机和电脑这个接口就类似于数据线如果我们想用数据线把东西在两个设备之前传输就需要两者可以接受彼此的传输协议。如我们在电子商务中经常就会用到的电商API即商品详情关键字搜索等封装了商品详情介绍主图商品价格商品SKU数据等API数据接口以获取商品信息。
对一个应用程序来说如果你想快速的和它交换数据也需要采用应用程序可以识别的规则。对于一些成熟的应用程序和网站来说通常都会提供自己的一套API供开发者友好的使用一方面可以大大扩展应用程序的生态环境另一方面也可以避免暴力的爬虫。
我们通过下图的「印象笔记 API」为例如果你使用过印象笔记Evernote的话会发现大量第三方应用都可以支持绑定印象笔记账户进行各种创建笔记推送笔记等操作。这里不是印象笔记去适配第三方应用而是它提供了一个完善的 API可以供其他开发者来使用。 REST API
API 之后还有一个概念是 REST API。 REST(Representational State Transfer) 的中文翻译一般是「表现层状态转化」这也太抽象了吧这个架构是 Roy Thomas Fielding 在2000年的毕业论文里提到的他同时还是HTTP协议1.0版和1.1版的主要设计者、Apache服务器软件的作者之一、Apache基金会的第一任主席。
关于究竟什么是「表现层状态转化」这里就跳过了因为不跳过你也不会看我也解释不清楚。只需要了解符合 REST 设计风格的 Web API 称为 RESTful API有如下几个要点 资源地址URI比如http://example.com/resources。 传输的资源Web服务接受与返回的互联网媒体类型比如JSONXMLYAML等。 对资源的操作Web服务在该资源上所支持的一系列请求方法比如POSTGETPUT 或 DELETE。 常用数据库 API NCBI
NCBI 是啥就不介绍了如果太多的功能没用过 PubMed 应该怎么也用过。在 NCBI 的开发文档中有一个部分专门是讲 API 的。
NCBI 提供的 API 如下图所示如果需要可以去看看。 EMBL-EBI EMBL-EBI 来自于欧洲里面有很多很多数据库都是我们日常会使用的只是你可以还不知道它们和 EBI 有关系的例如存放了大量基因组及相关数据的 Ensembl 包括大量蛋白序列和功能信息的数据库 UniPort当然还有还有不逊色与 pubmed 的文献数据库 Europe PMC。
从个人的使用体验来说一般能用EBI的时候我就尽量会绕过NCBI因为整个一系列网站用起来都要更舒服些文档查起来更顺手些对一些有进阶需求的开发者会更友好些如果你有二次开发的需求经过对比不难理解我的感受。
目前 EBI 比较知名的几个数据库都有很不错的 RESTful API 支持。
其中 Ensembl 支持 21 个 POST 和 98 个 GET 操作可以在官方说明中查看Uniport 数据库 和 Europe PMC 也有大量的操作支持。通过这些 API 你就可以接触到数据库中有的所有信息和 33 million 的文献。另外EBI 还有一个 QuickGO 的网站也支持 RESTful API 。
他们的 API 完善到直接在 NAR 发了一篇文章。 可用的数据库和工具如下 使用 API
这里以 Ensembl 的一个基础 API 为例对使用方法进行简单的演示。如果我们在 Ensembl 的网站上查看一个基因会是如下页面。在左侧我圈出来的是和这个基因相关的所有信息其中99%的信息都可以通过 API 获取到。 查看单基因信息
这里以最基础的单基因信息查询作为示例。Ensembl 的 RUSTful API 支持使用各种语言实现既可以在 Unix 操作系统中使用 curl 和 wget 命令也可以使用 python java perl 和 R 语言来操作。
如果要是用 wget 来查询一个基因的话查询规则示例是http://rest.ensembl.org/lookup/id/AT4G34410?expand1。其实这就是一个简单的我们都能理解的「网址」其中 id 后面是我们要查询的基因id问号后面可以添加任意支持的参数。另外还需要 header 信息Content-type:application/json 来指定获取的资源类型。
运行命令如下 wget -q --headerContent-type:application/json \ http://rest.ensembl.org/lookup/id/AT4G34410?expand1 -O -
得到的内容会是一行 json 内容这个信息大家看到都是崩溃的我就不直接放上来了。我们可以使用一些命令和操作稍微进行美化。 wget -q --headerContent-type:application/json \ http://rest.ensembl.org/lookup/id/AT4G34410?expand1 -O - | jq . -
通过 jq 这个命令可以让输出变成标准的 json 格式。输出截图如下 为了更方面的处理 json 内容和进行后一步的分析我们可以移步到 R 中看看如何使用。
要在 R 使用 RUSTful API 并进行后续的 json 文件处理首先需要加载两个包httr 用来调取 GET 和 POST 等命令jsonlite 用来处理 json 格式的文件。
httr 会把 GET 的结果保存为一个 response 类型的对象其中包括了 url状态码以及header等各种各样的信息jsonlite 可以帮助我们根据需求提取 json 里的内容并输出为 list 对象。
简单的运行命令如下 # 加载 R 包 library(httr) library(jsonlite) # 指定 server server - http://rest.ensembl.org # 指定查询内容,为了方便展示这里 expand0 ext - /lookup/id/ENSG00000157764?expand0 # 使用 httr 包的 GET 进行查询 r - GET(paste(server, ext, sep ), content_type(application/json)) # 这里的 r 是一个response类型的对象。 # 将http错误转换为R错误方便debug stop_for_status(r)
到这里其实查询的步骤已经完成对象 r 的结构如下 接下来就是首先把这个对象中的内容转换为json然后在转换为table即可命令非常简单。 list - fromJSON(toJSON(content(r))) tb - do.call(rbind,list)
得到的table内容如下 如果需要稍微优雅一些可以改写为一个函数如果需要一次查找多个基因可以使用 POST 方法。
你可能会好奇使用 API 的优势在哪里。
如果只是查找一个基因API 的优势并不明显如果只是偶尔查找几个基因API 的优势也不明显。
那怎么使用就有优势了呢类比于「印象笔记」以及和它相关的使用了「印象笔记 API」的第三方应用不知道会不会给你一些启发。
话不能说的太透点到为止更多的应用场景我们以后有机会再聊。
