中国动物主题数据库

API服务说明

API服务说明
API接口说明

中国动物主题数据库API服务概述

目前，每一位中国动物主题数据库的用户具有申请API服务密匙的权限。如果您是开发者，您需要根据各自的应用场景，配置您的应用，相关文档如下：

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

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

API：

功能：

请求方法：

POST http://zoology.especies.cn/api/v1/dbaseName

参数说明：

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

返回字段说明：

参数

类型

说明

data

Json对象数组

参数

类型

说明

dbaseName

string[]

数据库名称的数组：

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

sum

string

数据库名称总数量

code

int

401：API密钥与IP不匹配
200：OK
1100：暂无数据库信息

message

string

提示内容，与code对应

实例： http://zoology.especies.cn/api/v1/dbaseName?apiKey=API服务密匙

{
	"code": 200,
	"data": {
		"sum": "10",
		"dbaseName": [
			"中国动物志数据库",
			"云南鸟类数据库",
			"中国动物物种编目数据库",
			"中国兽类数据库",
			"西南保护区脊椎动物分布名录",
			"云南鸟类数据库",
			"云南蝴蝶分布数据库",
			"中国灵长类物种文献及使用数据库",
			"西南县级脊椎动物分布名录",
			"云南森林昆虫动物分布名录"
		]
	},
	"message": "OK"
}

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

API：

功能：

请求方法：

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

参数说明：

参数	类型	说明
{scientificName}	string	学名，支持拉丁名和中文
{dbaseName}	string	数据库名称
{apiKey}	string	注册用户的API服务密匙

返回字段说明：

参数

类型

说明

data

Json对象数组

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

code

int

401：API密钥与IP不匹配
200：OK
1500：没有此物种
1502：暂无描述类型

message

string

提示内容，与code对应

实例： http://zoology.especies.cn/api/v1/descriptionType?scientificName=Aix galericulata&dbaseName=中国鸟类数据库&apiKey=API服务密匙

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

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

API：

功能：

请求方法：

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

参数说明：

参数	类型	说明
{scientificName}	string	学名，支持拉丁名和中文
{dbaseName}	string	数据库名称
{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

401：API密钥与IP不匹配
200：OK
1500：没有此物种
1502：暂无描述信息

message

string

提示内容，与code对应

实例： http://zoology.especies.cn/api/v1/description?scientificName=Aix galericulata&dbaseName=中国鸟类数据库&descriptionType=1&apiKey=API服务密匙

{
	"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"
}