描述

此操作返回表示指定分类的图像，或关于图像的信息。如果后缀是 .png，则返回图像内容数据。否则，将以指定的格式返回一个描述性记录。

这些64x64的缩略图来自http://phylopic.org/。如果一个特定的分类单元有多个图像，则任意选择一个。可以通过在任何分类名称查询中包含show=img来获得图像标识符。

用法

• /data1.2/taxa/icon.png?id=910
  

• /data1.2/taxa/icon.json?id=910

{
"elapsed_time":0.00112,
"records": [
{"oid":"php:910","uid":"411847f0-d585-42ce-b4c9-682a3b57088f","dmd":"2013-04-11 18:25:17","crd":"Charles Doolittle Walcott (vectorized by T. Michael Keesey)","lic":"http://creativecommons.org/publicdomain/mark/1.0/"}
]
}

参数

• id：返回与指定的图像标识符对应的图像，或关于图像的信息。
• taxon_id：返回与指定分类对应的图像或关于图像的信息。
• taxon_name：返回与指定的分类名称对应的图像或关于图像的信息。如果有多个名称与参数值匹配，则将使用数据库中出现次数最多的名称。也可以使用别名name。不能在同一个查询中同时指定taxon_name和taxon_id。
• save：指定将此请求的输出保存到的本地文件的名称。这种情况是否发生以及如何发生取决于你使用的是哪种网络浏览器。如果你想在浏览器中显示结果，你可以指定save=no。如果你不带任何值地指定这个参数，将会提供一个默认的文件名。

当然还可以使用任何特殊参数，请参阅PBDB Data Service：Special parameters（特殊参数）。

方法

这个数据服务接受以下HTTP方法：GET，HEAD。

响应值

使用此操作对HTTP请求的响应将包含以下列表中的字段。

字段名（pbdb）	字段名（com）	区块	描述
image_no	oid	basic	此图像的唯一标识符，由此数据库本地生成
record_type	typ	basic	记录类型：img表示image
taxon_no	tid	basic	与此图像相关联的分类单元的标识符。这个字段只会出现在taxa/list_images生成的结果中。
taxon_name	tna	tasic	与此图像相关联的分类名称。这个字段只会出现在taxa/list_images生成的结果中。
uid	uid	basic	这个图像的唯一标识符由phylopic.org生成
modified	dmd	basic	此图像最后一次在phylopic.org上修改的日期和时间
credit	crd	basic	如果使用此图像，则应将其命名
license	lic	basic	一个提供许可条款的URL，在此许可条款下可以使用此图像

格式

以下响应格式可用于此操作。您必须通过向URI路径添加适当的后缀来为请求选择所需的格式。

格式	后缀	文档
JSON	.json	JSON format
Comma-separated text	.txt	Text formats
Comma-separated text	.csv	Text formats
Tab-separated text	.tsv	Text formats
PNG	.png	PNG format

术语表

术语表	名称	默认格式	描述
PaleobioDB field names	pbdb	txt, csv, tsv	PBDB词汇表来自数据库中的基础字段名和值，并增加了一些新字段。在大多数情况下，使用此词汇表的响应将直接与从PBDB Classic接口下载的响应相比较。此词汇表是Text格式响应的默认词汇。
Compact field names	com	json	Compact词汇表是一组3个字符的字段名，旨在将响应消息的大小最小化。这是JSON格式响应的默认值。一些字段值被类似地简化，而其他字段值则被完整地传递。