中国动物主题数据库

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