PBDB Data Service：Add measurement records or update existing records（添加测量记录或更新现有记录）

描述

此操作允许您向数据库添加新的样本测量记录和/或更新现有记录的属性。

您可以在URL中(使用GET方法)或在JSON格式的请求正文中(使用PUT方法)提供必要的参数。对于后者，您可以指定多个记录。如果您有权限，任何指定教育资源标识符的记录都将更新该记录的属性。否则，将创建一个新记录，归您所有。

默认情况下，此操作返回新的或更新的记录。

参数

以下参数指定了此操作应该返回的内容

• return：此参数指定更新操作应该返回哪些记录。您可以选择仅返回更新的记录、与至少有一条更新记录的任何标本相关的所有测量记录，或者什么都不返回。

    updated
    仅返回新的或更新的测量记录。这是默认值。
  
    specimen
    返回至少有一个更新记录的每个标本的测量记录的完整列表。
  
    none
    除了状态代码和生成的任何警告或注意之外，不返回任何内容。
  

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

主体

没有为这个操作给出主体定义。

方法

此数据服务接受以下HTTP方法：GET、POST、PUT

响应

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

1：basic

字段名（pbdb）	字段名（com）	描述
measurement_no	oid	此度量在数据库中的唯一标识符
_label	rlb	对于新添加或更新的记录，此字段将报告与每条记录一起提交的记录标签值（如果有）。
specimen_no	sid	与此测量相关联的标本标识符
record_type	typ	该对象的类型:mea表示测量。
n_measured	smn	测量项目数
position	mpo	测量项目的位置（如果有记录）
measurement_type	mty	实际测量结果
average	mva	平均测量值，或仅测量一个项目时的单个值
min	mvl	最小测量值(如果有记录)
max	mvu	最大测量值（如果记录）

格式

以下响应格式可用于此操作。必须通过向 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格式响应的默认值。一些字段值被类似地简化，而其他字段值则被完整地传递。