PBDB Data Service:Add measurement records or update existing records(添加测量记录或更新现有记录)

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格式响应的默认值。一些字段值被类似地简化,而其他字段值则被完整地传递。

猜你喜欢

转载自blog.csdn.net/whitedrogen/article/details/130691311