Inserir dados - POST

Como importar dados ao OpenDataBio usando a API

15 minute read

Importando dados

O pacote OpenDataBio é um cliente para esta API e permite importar dados a partir de objetos da linguagem R (exemplos);
Dados podem ser importados via interface web através de planilhas, onde os nomes das colunas são Parâmetros POST listados nesta página
O token de autenticação é necessário para solicitações POST
Importações podem ser executadas como UserJobs em segundo plano. Uma tarefa concluída ainda pode conter avisos ou erros por registro; confira os resultados estruturados.

O antigo endpoint de importação de atividades foi removido. Use o endpoint identification-histories para o histórico biológico de identificações. O log de atividades da aplicação é uma trilha de auditoria, não um histórico biológico importável.

Dados estruturados personalizados no campo `notes`

No campo notes de qualquer modelo, você pode armazenar texto simples ou um texto formatado como um objeto JSON contendo dados estruturados. A opção Json permite que você armazene dados estruturados personalizados em qualquer modelo que tenha o campo notes. Esses dados não serão validados pelo OpenDataBio e a padronização de tags e valores depende de você.

Endpoints POST

bibreferences (POST)

Referências bibliográficas (GET lista, POST cria).

Parâmetro	Obrigatório	Descrição	Exemplo
`bibtex`	Não	Referência em formato BibTeX. (Provide doi or bibtex.)	`@article{meuchave,...}`
`doi`	Não	Número ou URL de DOI. (Provide doi or bibtex.)	`10.1234/abcd.2020.1`

biocollections (POST)

Biocoleções (GET lista, POST cria).

Parâmetro	Obrigatório	Descrição	Exemplo
`acronym`	Sim	Sigla da biocoleção.	`INPA`
`name`	Sim	Parametro generico de nome (taxon completo, local, export_name de trait, etc.).	`Ocotea guianensis`

individuals (POST)

Indivíduos (GET lista, POST cria, PUT atualiza).

Parâmetro	Obrigatório	Descrição	Exemplo
`altitude`	Não	Altitude em metros.	`75`
`angle`	Não	Azimute em graus a partir do ponto de referência.	`45`
`biocollection`	Não	Id, nome ou sigla da biocoleção.	`INPA`
`biocollection_number`	Não	Número/código do voucher na biocoleção.	`12345`
`biocollection_type`	Não	Código ou nome do tipo nomenclatural.	`Holotype ou 2`
`collector`	Sim	Coletor(es) id, abreviação, nome ou email. Separe múltiplos com \| ou ;, primeiro e o principal.	`Silva, J.B.\|Costa, M.`
`dataset`	Sim	Id ou sigla do dataset.	`3 ou FOREST1`
`date`	Sim	Data (AAAA-MM-DD) ou data incompleta (ex. 1888-05-NA) ou array com year/month/day. (At least the year must be provided.)	`2024-05-20 ou {\"year\":1888,\"month\":5}`
`distance`	Não	Distância ao ponto de referência em metros.	`12.5`
`identification_based_on_biocollection`	Não	Nome/id da biocoleção usada como referência de identificacao.	`INPA`
`identification_based_on_biocollection_number`	Não	O catalogNumber do voucher usado como referência.	`8765`
`identification_date`	Não	Data da identificacao (completa ou incompleta).	`2023-06-NA`
`identification_individual`	Não	Id/organismID do indivíduo cuja identificacao sera reaproveitada.	`3245 ou REC-123`
`identification_notes`	Não	Notas da identificacao.	`Conferido em microscopia`
`identifier`	Não	Pessoa(s) responsavel(is) pela identificacao; aceita id, abreviação, nome ou email; use \| ou ;. Obrigatório quando taxon é informado. Use identifier=collector para usar o valor de collector informado no mesmo registro, ou identifier=keep em updates para preservar o identificador existente.	`A.Costa\|B.Lima ou collector ou keep`
`latitude`	Não	Latitude em graus decimais (negativo para sul). (Required when location is not provided.)	`-3.101`
`location`	Não	Id ou nome do local. (Required when latitude/longitude are not provided.)	`Parcela 25ha ou 55`
`location_date_time`	Não	Data ou data+hora do evento de localização/ocorrência. (Required when adding multiple locations or when different from individual date.)	`2023-08-14 12:30:00`
`location_notes`	Não	Notas da ocorrência/local.	`Perto do marco 10`
`longitude`	Não	Longitude em graus decimais (negativo para oeste). (Required when location is not provided.)	`-60.12`
`modifier`	Não	Código/nome do modificador de identificacao (s.s.=1, s.l.=2, cf.=3, aff.=4, vel aff.=5).	`3`
`notes`	Não	Notas em texto ou JSON.	`{\"expedition\":\"2024-01\",\"tag\":\"P1\"}`
`tag`	Sim	Tag/número/código do indivíduo.	`A-1234`
`taxon`	Não	Id ou nome canônico do taxon (lista aceita).	`Licaria cannela,Licaria armeniaca ou 456,789`
`x`	Não	Coordenada cartesiana do indivívudo na parcela ou transecto, a partir da origem	`10`
`y`	Não	Coordenada cartesiana do indivívudo na parcela ou transecto. Quando transecto, valores positivos (lado direito), valores negativos (lado esquerdo), a partir da origem	`5.1`

individual-locations (POST)

Ocorrências para indivíduos com múltiplas localizações (GET lista, POST/PUT grava).

Parâmetro	Obrigatório	Descrição	Exemplo
`altitude`	Não	Altitude em metros.	`75`
`angle`	Não	Azimute em graus a partir do ponto de referência.	`45`
`distance`	Não	Distância ao ponto de referência em metros.	`12.5`
`individual`	Sim	Id, uuid ou organismID do indivíduo.	`4521 ou 2ff0e884-3d33`
`latitude`	Não	Latitude em graus decimais (negativo para sul). (Required when location is not provided.)	`-3.101`
`location`	Não	Id ou nome do local. (Required when latitude/longitude are not provided.)	`Parcela 25ha ou 55`
`location_date_time`	Sim	Data ou data+hora do evento de localização/ocorrência.	`2023-08-14 12:30:00`
`location_notes`	Não	Notas da ocorrência/local.	`Perto do marco 10`
`longitude`	Não	Longitude em graus decimais (negativo para oeste). (Required when location is not provided.)	`-60.12`
`x`	Não	Coordenada cartesiana do indivívudo na parcela ou transecto, a partir da origem	`10`
`y`	Não	Coordenada cartesiana do indivívudo na parcela ou transecto. Quando transecto, valores positivos (lado direito), valores negativos (lado esquerdo), a partir da origem	`5.1`

locations (POST)

Localidades (GET lista, POST cria, PUT atualiza).

Parâmetro	Obrigatório	Descrição	Exemplo
`adm_level`	Sim	Código do nível administrativo do local (ex. 100=parcela, 10=país).	`100`
`altitude`	Não	Altitude em metros.	`75`
`azimuth`	Não	Azimute (graus) usado para montar geometria de plot/transecto quando o local e POINT.	`90`
`datum`	Não	Datum/projecao espacial.	`EPSG:4326-WGS 84`
`geojson`	Não	Feature GeoJSON de entrada, com geometria e pelo menos name + adm_level nas properties. Ela é convertida para a geometria da localidade e não é armazenada em coluna locations.geojson. (Provide geojson, geom or lat+long.)	`{\"type\":\"Feature\",\"properties\":{\"name\":\"Plot A\",\"adm_level\":100},\"geometry\":{...}}`
`geom`	Não	Geometria WKT (POINT, LINESTRING, POLYGON, MULTIPOLYGON). (Provide geojson, geom or lat+long.)	`POLYGON((-60 -3,-60.1 -3,-60.1 -3.1,-60 -3.1,-60 -3))`
`ismarine`	Não	Flag para aceitar locais marinhos fora de poligonos de país.	`1`
`lat`	Não	Latitude em graus decimais (negativo para sul). (Provide geojson, geom or lat+long.)	`-3.101`
`long`	Não	Longitude em graus decimais (negativo para oeste). (Provide geojson, geom or lat+long.)	`-60.12`
`name`	Sim	Parametro generico de nome (taxon completo, local, export_name de trait, etc.).	`Ocotea guianensis`
`notes`	Não	Notas em texto ou JSON.	`{\"expedition\":\"2024-01\",\"tag\":\"P1\"}`
`parent`	Não	Id ou nome do pai (taxon ou local).	`Lauraceae ou 210`
`startx`	Não	Coordenada X inicial de subparcela em relação ao plot pai.	`5.5`
`starty`	Não	Coordenada Y inicial de subparcela em relação ao plot pai.	`10.0`
`x`	Não	Dimensão X para plots ou comprimento transecto	`100`
`y`	Não	Dimensão Y para plots ou buffer para transectos (PELD)	`40`

locations-validation (POST)

Valida coordenadas com locais registrados (POST).

Parâmetro	Obrigatório	Descrição	Exemplo
`latitude`	Sim	Latitude em graus decimais (negativo para sul).	`-3.101`
`longitude`	Sim	Longitude em graus decimais (negativo para oeste).	`-60.12`

measurements (POST)

Medições de traits (GET lista, POST cria via job de importação, PUT atualiza).

Parâmetro	Obrigatório	Descrição	Exemplo
`bibreference`	Não	Id ou bibkey da referência.	`34`
`dataset`	Sim	ID/nome do dataset onde a medição será armazenada; se omitido, usa o dataset padrão do usuário autenticado se existir.	`3 ou FOREST1`
`date`	Sim	Data da medição; aceita YYYY-MM-DD, YYYY-MM, YYYY, ou campos em array ano-mês-dia (date_year/date_month/date_day).	`2024-05-10 ou 2024-05 ou {"year":2024,"month":5}`
`duplicated`	Não	Número sequencial para permitir medidas duplicadas do mesmo trait/objeto/data.	`2 para o segundo registro, 3 para o terceiro e assim por diante`
`link_id`	Não	Obrigatório para traços do tipo LINK: ID do objeto ligado (ex.: ID do Taxon). (Required when trait type is Link.)	`55`
`location`	Não	Id ou nome do local.	`Parcela 25ha ou 55`
`notes`	Não	Opcional. Texto livre ou notas em JSON armazenadas com a medição.	`{"method":"caliper"}`
`object_id`	Sim	Obrigatório. ID numérico do objeto medido (Individual, Location, Taxon, Voucher, Media). Alias: measured_id.	`4521`
`object_type`	Sim	Obrigatório quando não fornecido no header. Nome da classe ou FQCN do objeto medido (Individual, Location, Taxon, Voucher, Media). Alias: measured_type.	`Individual`
`parent_measurement`	Não	Quando a variável depende de outra medição, informe o ID da medição pai para o mesmo objeto e data.	`3001`
`person`	Sim	Id/abreviação/nome/email de pessoa (aceita lista com \| ou ;).	`Silva, J.B.\|Costa, M.`
`trait_id`	Sim	Obrigatório. ID ou export_name da variável medida. Alias: também aceita chave “trait”.	`treeDbh ou 12`
`value`	Não	Valor(es) da medida; depende do tipo do trait: QUANT_INTEGER (0) = número inteiro; QUANT_REAL (1) = número decimal, ponto como separator; CATEGORICAL or ORDINAL (2/4) = uma única categoria, pode ser o id ou o nome; CATEGORICAL_MULTIPLE (3) = lista de ids ou nomes de categorias separadas por \| ; ou ,; TEXT (5) = um texto livre; COLOR (6) = cor em formato hex #A1B2C3 or #ABC; LINK (7) = enviar o link_id do object (value pode ser vazio neste caso, ou um número); SPECTRAL (8) = valores de absorbânica/reflectância separados por ponto-e-vírgula (;) com mesmo número de valores especificados na definição da variável; GENEBANK (9) = código alfanumérico do accesso do registro no GenBank (ele é validado contra o NCBI). (Required unless trait type is Link.)	`QUANT_REAL: 23.4 \| CATEGORICAL: 15 ou Morta \| CATEGORICAL_MULTIPLE: 12;14 ou Simples;Composta \| SPECTRAL: 0.12;0.11;0.10`

media (POST)

Metadados de mídia (GET lista, POST cria, PUT atualiza).

Parâmetro	Obrigatório	Descrição	Exemplo
`collector`	Não	Coletor(es) id, abreviação, nome ou email. Separe múltiplos com \| ou ;, primeiro e o principal.	`Silva, J.B.\|Costa, M.`
`dataset`	Não	Id ou sigla do dataset.	`3 ou FOREST1`
`date`	Não	Data (AAAA-MM-DD) ou data incompleta (ex. 1888-05-NA) ou array com year/month/day.	`2024-05-20 ou {\"year\":1888,\"month\":5}`
`filename`	Sim	Nome exato do arquivo de mídia dentro do ZIP ao importar mídia.	`IMG_0001.jpg`
`latitude`	Não	Latitude em graus decimais (negativo para sul).	`-3.101`
`license`	Não	Licenca publica para mídia (CC0, CC-BY, CC-BY-SA, etc.).	`CC-BY-SA`
`location`	Não	Id ou nome do local.	`Parcela 25ha ou 55`
`longitude`	Não	Longitude em graus decimais (negativo para oeste).	`-60.12`
`notes`	Não	Notas em texto ou JSON.	`{\"expedition\":\"2024-01\",\"tag\":\"P1\"}`
`object_id`	Sim	ID do objeto ao qual a mídia pertence (Indivíduo, Local, Táxon, Voucher).	`4521`
`object_type`	Sim	O tipo de objeto ao qual a mídia pertence, um dos seguintes: Individual, Local, Táxon ou Voucher.	`Individual`
`project`	Não	Id ou sigla do projeto.	`PDBFF ou 2`
`tags`	Não	Ids ou nomes de tags para mídia ou filtros (use \| ou ;).	`flower\|leaf`
`title_en`	Não	Titulo da mídia em ingles.	`Leaf detail`
`title_pt`	Não	Titulo da mídia em portugues.	`Detalhe da folha`

persons (POST)

Pessoas (GET lista, POST cria, PUT atualiza).

Parâmetro	Obrigatório	Descrição	Exemplo
`abbreviation`	Não	Abreviação padrão de pessoa ou coleção.	`Silva, J.B.`
`biocollection`	Não	Id, nome ou sigla da biocoleção.	`INPA`
`email`	Não	Endereco de email.	`user@example.org`
`full_name`	Sim	Nome completo da pessoa.	`Joao Silva`
`institution`	Não	Instituicao associada a pessoa.	`INPA`

taxons (POST)

Nomes taxonômicos (GET lista, POST cria).

Parâmetro	Obrigatório	Descrição	Exemplo
`author`	Não	String opcional de autoria para nomes publicados. Em nomes publicados costuma ser preenchida automaticamente pela API. Para nomes não publicados, mantenha author nulo e use author_id/person.	`Nees`
`author_id`	Não	Alternativa a person para nomes não publicados. Obrigatório para nomes não publicados quando person não for enviado. (Required for unpublished names (or use person).)	`25`
`bibkey`	Não	Id da referência bibliográfica ou bibkey, opcional, para resolver bibreference_id. Em nomes publicados, dados bibliográficos vindos da API também podem preencher o registro.	`ducke1953 ou 34`
`bibreference`	Não	Id ou bibkey da referência.	`34`
`enforceValid`	Não	Override booleano opcional para nomes publicados. Use quando você enviar valid=true e quiser sobrescrever um resultado da API que marca o nome como inválido e define um nome sênior.	`1 ou true`
`gbif`	Não	Id opcional do GBIF. No POST ele é armazenado como informado; não há validação adicional por API para esse valor explícito.	`28792`
`indexfungorum`	Não	Identificador Index Fungorum de um táxon.	`IF123456`
`ipni`	Não	Id opcional do IPNI. No POST ele é armazenado como informado; não há validação adicional por API para esse valor explícito.	`123456-1`
`level`	Não	Opcional para nomes publicados porque a API pode defini-lo. Obrigatório para nomes não publicados exceto quando o nome validado tem duas palavras, caso em que será importado como species. Aceita código numérico do rank ou nome do rank como species/subspecies/clade.	`210 ou species`
`mobot`	Não	Id opcional do Tropicos/MOBOT. No POST ele é armazenado como informado; não há validação adicional por API para esse valor explícito.	`25509881`
`mycobank`	Não	Id opcional do MycoBank. No POST ele é armazenado como informado; não há validação adicional por API para esse valor explícito.	`MB123456`
`name`	Sim	Nome do táxon, obrigatório. Para nomes publicados, o POST consulta APIs nomenclaturais externas e pode normalizar nome, parent, rank, valid, senior_id, author, bibreference e ids externos. Para nomes não publicados, informe author_id/person e parent; level é obrigatório exceto quando o nome validado tem duas palavras, caso em que será importado como species.	`Ocotea guianensis ou Inga sp. 1`
`parent`	Não	Opcional para nomes publicados, obrigatório para nomes não publicados. Aceita id do táxon pai ou nome científico. Para nomes publicados, se a API encontrar um pai diferente, o pai informado é mantido e um aviso é registrado no log. (Required for unpublished names.)	`Ocotea ou 120`
`parent_id`	Não	Id do pai para consultas hierarquicas.	`210`
`parent_name`	Não	Nome alternativo do táxon pai usado em importações e atualizações de táxons.	`Ocotea`
`person`	Não	Use apenas para nomes não publicados. Aceita id, abreviação, nome completo ou email da pessoa e resolve para author_id. Quando presente, o registro é tratado como não publicado e a busca em API não é usada. (Required for unpublished names (or use author_id).)	`25 ou Pilco, M.V.`
`senior`	Não	Id ou nome do táxon sênior aceito usado ao importar um táxon inválido.	`Ocotea guianensis`
`senior_id`	Não	Id opcional do nome aceito quando o táxon importado é inválido. O táxon sênior deve existir, ser válido e ser publicado.	`345`
`valid`	Não	Booleano opcional. Quando omitido no POST, a validade é inferida a partir de senior/senior_id ou do resultado da API. Nomes inválidos são permitidos tanto para táxons publicados quanto não publicados. Se você enviar valid=true para um nome publicado e a API disser que o nome é inválido, a importação é rejeitada, a menos que enforceValid=true também seja enviado.	`1 ou 0`
`zoobank`	Não	Id opcional do ZooBank. No POST ele é armazenado como informado; não há validação adicional por API para esse valor explícito.	`urn:lsid:zoobank.org:act:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`

traits (POST)

Definições de traits (GET lista, POST cria).

Parâmetro	Obrigatório	Descrição	Exemplo
`bibreference`	Não	Id ou bibkey da referência.	`34`
`categories`	Não	Lista JSON de categorias de trait com lang/rank/name/description. (Required for categorical and ordinal traits.)	`[{\"lang\":\"en\",\"rank\":1,\"name\":\"small\"}]`
`description`	Sim	Descrição em texto ou mapa de traducao.	`{\"en\":\"Leaf length\",\"pt-br\":\"Comprimento da folha\"}`
`export_name`	Sim	Nome de exportação unico do trait.	`DBH`
`link_type`	Não	Classe alvo do trait tipo Link (ex. Taxon). (Required for Link traits.)	`Taxon`
`name`	Sim	Parametro generico de nome (taxon completo, local, export_name de trait, etc.).	`Ocotea guianensis`
`objects`	Sim	Objetos alvo do trait (separados por virgula).	`Individual,Voucher`
`parent`	Não	ID da característica pai ou nome de exportação; quando definido, as medições desta característica também devem incluir uma medição para a característica pai.	`woodDensity`
`range_max`	Não	Valor máximo permitido para traits quantitativos.	`999.9`
`range_min`	Não	Valor mínimo permitido para traits quantitativos.	`0.01`
`tags`	Não	Ids ou nomes de tags para mídia ou filtros (use \| ou ;).	`flower\|leaf`
`type`	Sim	Parametro generico type (código do trait ou tipo de vernacular: use/generic/etimology).	`use ou 10`
`unit`	Não	(Required for quantitative and spectral traits.)	—
`value_length`	Não	Número de valores para trait espectral. (Required for spectral traits.)	`1024`
`wavenumber_max`	Não	Número de onda máximo para traits espectrais. (Required for spectral traits.)	`25000`
`wavenumber_min`	Não	Número de onda mínimo para traits espectrais. (Required for spectral traits.)	`4000`

vernaculars (POST)

Nomes vernáculos (GET lista, POST cria).

Parâmetro	Obrigatório	Descrição	Exemplo
`citations`	Não	Lista de citacoes (texto + bibreference) para vernaculares.	`[{\"citation\":\"Silva 2020\",\"bibreference\":12}]`
`individuals`	Não	Lista de ids/nomes de indivíduos para vincular vernacular.	`12\|23\|45`
`language`	Sim	Id/código/nome do idioma. Para POST vernaculars, idiomas cadastrados são aceitos; idiomas ausentes são criados a partir de config/languagesISO6393.php apenas quando o valor informado corresponder a código ISO639-3 ou nome configurado, com is_locale=0.	`en ou 1 ou english ou spa`
`name`	Sim	Parametro generico de nome (taxon completo, local, export_name de trait, etc.).	`Ocotea guianensis`
`notes`	Não	Notas em texto ou JSON.	`{\"expedition\":\"2024-01\",\"tag\":\"P1\"}`
`parent`	Não	Id ou nome do pai (taxon ou local).	`Lauraceae ou 210`
`taxons`	Não	Lista de ids/nomes de taxon (para vernacular).	`Euterpe edulis\|Ocotea guianensis`
`type`	Não	Parametro generico type (código do trait ou tipo de vernacular: use/generic/etimology).	`use ou 10`

vouchers (POST)

Vouchers de coleção (GET lista, POST cria, PUT atualiza).

Parâmetro	Obrigatório	Descrição	Exemplo
`biocollection`	Sim	Id, nome ou sigla da biocoleção.	`INPA`
`biocollection_number`	Não	Número/código do voucher na biocoleção.	`12345`
`biocollection_type`	Não	Código ou nome do tipo nomenclatural.	`Holotype ou 2`
`collector`	Não	Coletor(es) id, abreviação, nome ou email. Separe múltiplos com \| ou ;, primeiro e o principal.	`Silva, J.B.\|Costa, M.`
`dataset`	Não	Id ou sigla do dataset.	`3 ou FOREST1`
`date`	Não	Data (AAAA-MM-DD) ou data incompleta (ex. 1888-05-NA) ou array com year/month/day.	`2024-05-20 ou {\"year\":1888,\"month\":5}`
`individual`	Sim	Id, uuid ou organismID do indivíduo.	`4521 ou 2ff0e884-3d33`
`notes`	Não	Notas em texto ou JSON.	`{\"expedition\":\"2024-01\",\"tag\":\"P1\"}`
`number`	Não	Número/código de coletor (voucher ou tag quando diferente).	`1234A`

datasets (POST)

Datasets e versões publicadas de datasets (GET lista, POST cria via job de importação).

Parâmetro	Obrigatório	Descrição	Exemplo
`description`	Não	Descrição em texto ou mapa de traducao. (Required when privacy is 2 or 3.)	`{\"en\":\"Leaf length\",\"pt-br\":\"Comprimento da folha\"}`
`license`	Não	Licenca publica para mídia (CC0, CC-BY, CC-BY-SA, etc.). (Required when privacy is 2 or 3.)	`CC-BY-SA`
`name`	Sim	Short name or nickname for the dataset - make informative, shorter than title.	`Morphometrics-Aniba`
`privacy`	Sim	(Accepted values: 0 (auth), 1 (project), 2 (registered), 3 (public).)	—
`project_id`	Não	(Required when privacy is 1 (project).)	—
`share_taxon_list`	Não	Opção do dataset que controla se a lista de táxons pode ser compartilhada em contextos públicos de filogenia/lista taxonômica. (Optional boolean; defaults to true.)	`1 ou true`
`title`	Não	(Required when privacy is 2 or 3.)	—
`visibility`	Não	(Optional for privacy 0 or 1; mandatory true when privacy is 2 or 3.)	—

identification-histories (POST)

Histórico de identificações (GET lista, POST cria linhas manuais de histórico).

Parâmetro	Obrigatório	Descrição	Exemplo
`biocollection_id`	Não	Lista de ids de biocoleção para filtrar vouchers.	`1,5`
`biocollection_reference`	Não	(Requires biocollection_id when provided.)	—
`date`	Sim	Data (AAAA-MM-DD) ou data incompleta (ex. 1888-05-NA) ou array com year/month/day.	`2024-05-20 ou {\"year\":1888,\"month\":5}`
`identification_id`	Não	Id do registro de identificação. Para POST identification-histories é opcional; quando informado, deve pertencer ao individual_id. Quando omitido, a API deriva a identificação a partir de individual_id. (Optional. When provided, it must belong to individual_id; otherwise it is derived from individual_id.)	`123`
`identifier`	Não	Pessoa(s) responsavel(is) pela identificacao; aceita id, abreviação, nome ou email; use \| ou ;. Obrigatório quando taxon é informado. Use identifier=collector para usar o valor de collector informado no mesmo registro, ou identifier=keep em updates para preservar o identificador existente. (Provide identifier, identifier_id, or identifiers.)	`A.Costa\|B.Lima ou collector ou keep`
`identifier_id`	Não	Id de pessoa ou lista delimitada de ids de pessoas responsáveis pela identificação. (Provide identifier, identifier_id, or identifiers.)	`4 ou 4\|7`
`identifiers`	Não	Referência de pessoa ou lista delimitada de pessoas responsáveis pela identificação. Cada item pode ser id, abreviação, nome completo ou email. (Provide identifier, identifier_id, or identifiers.)	`4\|7 ou A.Costa\|B.Lima`
`individual_id`	Sim	Ids de indivíduos para ocorrências.	`12,55,90`
`modifier`	Não	Código/nome do modificador de identificacao (s.s.=1, s.l.=2, cf.=3, aff.=4, vel aff.=5).	`3`
`notes`	Não	Notas em texto ou JSON.	`{\"expedition\":\"2024-01\",\"tag\":\"P1\"}`
`replaced_at`	Não	Data/hora em que a identificação foi substituída.	`2026-06-11 10:30:00`
`source`	Não	Rótulo de origem para registros gerados ou importados.	`api`
`taxon_id`	Sim		—

Última modificação July 10, 2026: Updated docs to odb version 0.10.0-alpha2 (886b968)