PBDB Data Service: Add measurement records or update existing records (add measurement records or update existing records)

describe

This action allows you to add new sample measurement records to the database and/or update the properties of existing records.

You can provide the necessary parameters in the URL (with the GET method) or in the request body in JSON format (with the PUT method). For the latter, you can specify multiple records. If you have permission, any record that specifies an educational resource identifier will update that record's properties. Otherwise, a new record will be created, owned by you.

By default, this operation returns new or updated records.

parameter

The following parameters specify what this operation should return

• return : This parameter specifies which records the update operation should return. You can choose to return only updated records, all measurement records associated with any specimen that has at least one updated record, or return nothing.

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

Of course you can also use anyspecial parameters, see PBDB Data Service: Special parameters (special parameters) .

main body

No body definition is given for this operation.

method

This data service accepts the following HTTP methods: GET, POST, PUT

response

Responses to HTTP requests using this operation will contain the fields in the following list.

1：basic

field name (pbdb)	field name (com)	describe
measurement_no	oid	A unique identifier for this metric in the database
_label	rlb	For newly added or updated records, this field will report the record tag value (if any) that was submitted with each record.
specimen_no	sid	the specimen identifier associated with this measurement
record_type	typ	The type of this object: mea means measure.
n_measured	smn	Number of measurement items
position	mpo	The location of the measured item (if documented)
measurement_type	mty	Actual measurement result
average	mva	Average measured value, or a single value when only one item is measured
min	mvl	Minimum measured value (if recorded)
max	mvv	Maximum measured value (if recorded)

Format

The following response formats are available for this operation. The desired format must be selected for the request by adding the appropriate suffix to the URI path.

Format	suffix	document
JSON	.json	JSON format
Comma-separated text	.txt	Text formats
Comma-separated text	.csv	Text formats
Tab-separated text	.tsv	Text formats

Glossary

Glossary	name	default format	describe
PaleobioDB field names	pbdb	txt, csv, tsv	The PBDB vocabulary is derived from the base field names and values ​​in the database, with some new fields added. In most cases, responses using this vocabulary will be compared directly to those downloaded from the PBDB Classic interface. This vocabulary is the default vocabulary for Text formatted responses.
Compact field names	com	json	The Compact vocabulary is a set of 3-character field names designed to minimize the size of response messages. This is the default for JSON-formatted responses. Some field values ​​are similarly simplified, while others are passed intact.