生物百科

API服务说明

API服务说明
API v1 接口说明

生物百科API服务概述

目前，每一位百科的注册用户都会拥有一个自己独享的API服务密匙。如果您是开发者，您需要根据各自的应用场景，配置您的应用，相关文档如下：

网站或者站外Web应用、桌面和无线客户端应用，请参考： API接口说明，并设置您的应用支持解析json格式的数据。

查询数据源名称，返回所有数据源的名称集合

API：

功能：

请求方法：

POST http://baike.especies.cn/api/v1/datasourceName

参数说明：

参数	必选	类型	说明
{apiKey}		string	注册用户的API服务密匙

返回字段说明：

参数

类型

说明

data

Json对象数组

参数

类型

说明

fungus
plant
animal

List

数据库名称的数组：

参数	类型
数据源名称	string

code

int

200：OK
401：API密钥错误
402：API请求次数达到上限
500：未知错误
1100：暂无数据源信息

message

string

提示内容，与code对应

实例：

{
	"code": 200,
	"message": "OK",
	"data": {
		"fungus": [
			"中国菌物名录数据库"
		],
		"plant": [
			"中国植物志"
		],
		"animal": [
			"中国动物志数据库",
			"云南鸟类数据库",
			"中国蜜蜂数据库",
			"中国动物物种编目数据库",
			"中国兽类数据库"
		]
	}
}

根据物种学名、数据源名称和类型，返回对应的描述类型信息

API：

功能：

请求方法：

POST http://baike.especies.cn/api/v1/descriptionType

参数说明：

参数	类型	说明
{scientificName}	string	学名，支持拉丁名和中文
{datasourceName}	string	数据源名称
{type}	string	类型：fungus / plant / animal
{apiKey}	string	注册用户的API服务密匙

返回字段说明：

参数

类型

说明

data

Json对象数组

参数	类型	说明
desType	Json对象数组	某一个数据源下物种的所有描述类型信息(ID和名称)

code

int

200：OK
401：API密钥错误
402：API请求次数达到上限
500：未知错误
1500：没有此物种
1501：暂无描述类型

message

string

提示内容，与code对应

实例：

{
	"code": 200,
	"data": {
		"desType": [
			{
				"1": "形态描述"
			},
			{
				"101": "生物学"
			},
			{
				"152": "生境信息"
			},
			{
				"159": "鸣声描述"
			},
			{
				"204": "分布范围"
			},
			{
				"208": "国外分布"
			},
			{
				"209": "国内分布"
			}
		]
	},
	"message": "OK"
}

根据物种学名、数据源名称、类型和描述类型，返回对应的描述信息

API：

功能：

请求方法：

POST http://baike.especies.cn/api/v1/description

参数说明：

参数	类型	说明
{scientificName}	string	学名，支持拉丁名和中文
{datasourceName}	string	数据源名称
{type}	string	类型：fungus / plant / animal
{descriptionType}	string	描述类型ID
{apiKey}	string	注册用户的API服务密匙

返回字段说明：

参数

类型

说明

data

Json对象数组

参数

类型

说明

scientificName

string

学名（接受名），包括了命名人和命名年代

DescriptionInfo

Json对象数组

描述信息：

参数

类型

说明

destitle

string

描述标题

descontent

string

描述内容

refs

string[]

描述信息的参考文献：

参数	类型	说明
[i]	string	文献，对象名为[i]，其中i为从0开始的正整数，有几条文献就延续到几

code

int

200：OK
401：API密钥错误
402：API请求次数达到上限
500：未知错误
1500：没有此物种
1502：暂无描述类型

message

string

提示内容，与code对应

实例：

{
	"code": 200,
	"data": {
		"scientificName": "Emberiza hortulana",
		"DescriptionInfo": [
			{
				"refs": [
					"约翰.马敬能,卡伦.菲利普斯,何芬奇，2000. 中国野生鸟类手册. 长沙: 湖南教育出版社"
				],
				"descontent": "描述：体型略大(16厘米)的鹀。头及胸清绿灰色，浅色眼圈显著，黄色的髭下纹及喉部成特殊图纹。与灰颈鹀的区别在胸偏灰而与棕色的腹部截然分开，头灰而偏绿，翼斑常为白色。雌鸟及幼鸟色暗，顶冠、颈背及胸具黑色纵纹，无眉纹、粗显的皮黄色下髭纹及头部的绿染有别于其他的鹀。虹膜－深褐；嘴－粉红；脚－粉红。",
				"destitle": "Emberiza hortulana的形态描述"
			},
			{
				"refs": [
					"约翰.马敬能，卡伦.菲利普斯，何芬奇（2000），中国鸟类野外手册，湖南教育出版社,pp1-571"
				],
				"descontent": "体型略大(16厘米)的鹀。头及胸清绿灰色，浅色眼圈显著，黄色的髭下纹及喉部成特殊图纹。与灰颈鹀的区别在胸偏灰而与棕色的腹部截然分开，头灰而偏绿，翼斑常为白色。雌鸟及幼鸟色暗，顶冠、颈背及胸具黑色纵纹，无眉纹、粗显的皮黄色下髭纹及头部的绿染有别于其他的鹀。
虹膜－深褐；嘴－粉红；脚－粉红。
",
				"destitle": "Emberiza hortulana的形态描述"
			}
		]
	},
	"message": "OK"
}