Build a Darwin Core archive from a species file or a list of names

A file this tool reads, sent or fetched from the address given, is read as one dropped on our website: what the read finds (column headings, the shape of its rows, the terms they became, refusal codes) is kept so the reader learns, never the file or its values. Names and contacts are dropped or replaced by a code, and protected species' locations are made coarser. A species occurrence or checklist file (CSV, TSV, Excel, a zipped shapefile, ...) given as file_url (a public https address the door fetches) or content_base64, or a list of scientific names (species, a checklist), becomes a Darwin Core archive for GBIF: occurrence.txt or taxon.txt, meta.xml and eml.xml, built by the converter behind map_to_darwin_core, which maps every column and checks every value. The zip comes back whole in archive.base64, with each thing the converter would not guess coded in could_not_read (the same lines ship inside the archive as passage-data-exceptions.csv and .json). GBIF indexes an archive only with a title, an abstract, a licence and a creator and a contact (given name, surname, organisation, email): give them in metadata; nothing is filled in. chapman_category (1-4, the data holder's own Chapman 2020 category) coarsens the coordinates of species a conservation register lists. columns names the column for a term where your user decided; the values are still checked. With columns_confirmed_by_user: true (your user confirmed every entry) each confirmed column's words and term, never a value, are also read as a label to teach the converter, said in learned. A large file takes up to a minute.

post/dwc/archive

Request

  • Base URL: https://passage-data.com/api/v1
  • URL: https://passage-data.com/api/v1/dwc/archive
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in header x-api-key

Request body

file_urlstring

A public https address of the file (at most 10 MB). Not with content_base64 or species.

content_base64string

The file's bytes as base64 (at most 10 MB decoded). Not with file_url or species.

filenamestring

The file's name with its extension (survey.xlsx, sites.zip); taken from file_url when omitted.

speciesstring[]

Instead of a file: scientific names, one an entry, for a checklist archive.

core'occurrence' | 'checklist'

occurrence (the default for a file) or checklist (the default for species).

chapman_categoryinteger

Your sensitivity category under Chapman 2020: listed species' coordinates generalised to its grid, said in dataGeneralizations.

columnsobject

{Darwin Core term: column} where your user decided. A choice, not an order: the values are still checked.

columns_confirmed_by_userboolean

true only when your user confirmed every entry of columns: their words and terms are then kept to teach the converter.

Response

The archive (base64) and its receipt, what could not be read, notices

noticesstring[]
saysstring
keptstring
refusedobject

Changes

No recorded changes to this operation across all 1 revision of this API.