PBDB Data Service：Specimen descriptive elements（标本描述性要素）

描述

此操作返回可用于描述标本的元素列表，例如’bone’, ‘tooth’, ‘valve’。

参数

以下参数选择要返回的记录

• all_records：根据给定的任何其他参数，返回数据库已知的所有样本元素记录。
• taxon_name：仅返回对指定分类单元有效的元素。
• taxon_id：只返回对指定分类单元有效的元素，由数据库中的标识符给出。
• name_re：仅返回名称或备用名称与给定正则表达式匹配的元素。

以下参数指定应返回的信息

• show：指示要与基本记录一起显示的其他信息。该值应为包含以下一个或多个值的逗号分隔列表：
  seq：包括来自分类单元树的预序遍历的序列号，该树将定义每个元素的分类单元括起来。

• order：指定返回结果的顺序。您可以指定多个以逗号分隔的值，每个值都可以追加 .asc 或 .desc。接受的值为：
  name：按名称的字母顺序返回元素。
  hierarchy：结果按分类学标识进行分层排序。姐妹分类群的顺序是任意的，但子类群总是会跟随父类群。

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

方法

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

响应结果

使用此操作对HTTP请求的响应将包含以下列表中的字段。区块basic是一直显示的。其他的可以使用参数show来选择。

1：basic

字段名（pbdb）	字段名（com）	描述
specelt_no	oid	该标本元素在数据库中的唯一标识
record_type	typ	此对象的类型：els表示标本要素。
element_name	nam	这个样本元素的名称
parent_name	par	父元素的名称(如果有)。这可用于在折叠列表中显示元素，其中单个元素可展开以显示其子元素。
alternate_names	alt	此元素的备用名称(如果有)。
taxon_name	tna	为其定义此元素的基本分类单元的名称。

格式

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

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

术语表

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