REST API

This is a documentation page. Click here to go to the full documentation index.
Table of contents

Most APIs work through Content Negotiation. Every API type lists the MIME types used for this. In some cases, regular file extensions are listed. They can be used as an alternative.

Metadata

Regular metadata export is enabled for almost everything. The schema is described here. The following formats are supported:

Format MIME type File extension
JSON application/json .json

The following paths are supported:

  • GET /abbreviations/*
  • GET /agadeMailsCdliTags/*
  • GET /agadeMails/*
  • GET /archives/*
  • GET /articlesAuthors/*
  • GET /articlesPublications/*
  • GET /articles/*
  • GET /artifactsCollections/*
  • GET /artifactsComposites/*
  • GET /artifactsDates/*
  • GET /artifactsExternalResources/*
  • GET /artifactsGenres/*
  • GET /artifactsLanguages/*
  • GET /artifactsMaterials/*
  • GET /artifactsPublications/*
  • GET /artifactsSeals/*
  • GET /artifactsShadow/*
  • GET /artifacts/*
  • GET /artifactsUpdates/*
  • GET /artifactTypes/*
  • GET /authorsPublications/*
  • GET /authors/*
  • GET /authorsUpdateEvents/*
  • GET /cdliTags/*
  • GET /collections/*
  • GET /dates/*
  • GET /dynasties/*
  • GET /editorsPublications/*
  • GET /editors/*
  • GET /entryTypes/*
  • GET /externalResources/*
  • GET /genres/*
  • GET /inscriptions/*
  • GET /journals/*
  • GET /languages/*
  • GET /materialAspects/*
  • GET /materialColors/*
  • GET /materials/*
  • GET /months/*
  • GET /periods/*
  • GET /postings/*
  • GET /postingTypes/*
  • GET /proveniences/*
  • GET /publications/*
  • GET /regions/*
  • GET /retiredArtifacts/*
  • GET /roles/*
  • GET /rolesUsers/*
  • GET /rulers/*
  • GET /signReadingsComments/*
  • GET /signReadings/*
  • GET /staff/*
  • GET /staffTypes/*
  • GET /updateEvents/*
  • GET /users/*
  • GET /years/*

Linked data

The CDLI catalog supports Linked Open Data output for catalog data. The following formats are supported:

Format MIME type File extension
JSON-LD application/ld+json .jsonld
RDF/JSON application/rdf+json -
RDF application/rdf+xml .xml, .rdf
N-Triples application/n-triples .nt
Turtle text/turtle, application/turtle, application/x-turtle .ttl

The following paths, part of the main catalog, support linked data APIs:

  • GET /archives/*
  • GET /artifacts/*
  • GET /artifactsExternalResources/*
  • GET /artifactsMaterials/*
  • GET /collections/*
  • GET /dates/*
  • GET /dynasties/*
  • GET /genres/*
  • GET /inscriptions/*
  • GET /languages/*
  • GET /materials/*
  • GET /materialAspects/*
  • GET /materialColors/*
  • GET /periods/*
  • GET /proveniences/*
  • GET /publications/*
  • GET /regions/*
  • GET /rulers/*

Bibliographies

Bibliography exports are supported for artifacts and publications. The following formats are supported:

Format MIME type File extension
BibTeX application/x-bibtex .bib
CSL-JSON application/vnd.citationstyles.csl+json -
Formatted bibliographies text/x-bibliography -
RIS application/x-research-info-systems .ris

Formatting is done using citeproc-js and CSL styles. To specify the bibliographic style of the formatted bibliographies, use the style query parameter. For styles that can be used, check out the CSL styles repository or Zotero's search index.

The following paths are supported:

  • GET /artifacts/*
  • GET /publications/*

Inscriptions

Inscriptions can be fetched from specific inscription versions or from the latest inscription of a given artifact. Note that CoNLL-RDF is included in the linked data export. The following formats are supported:

Format MIME type File extension
C-ATF text/x-c-atf -
CDLI-CoNLL text/x-cdli-conll -
CoNLL-U text/x-conll-u -

The following paths are supported:

  • GET /artifacts/*/inscription/*
  • GET /inscriptions/*

Tabular exports

Tabular exports are supported for artifacts, publications, and the links between the two (artifactsPublications). The following formats are supported:

Format MIME type File extension
CSV text/csv .csv
TSV text/tab-separated-values .tsv
Excel application/vnd.openxmlformats-officedocument.spreadsheetml.sheet .xlsx

The following paths are supported:

  • GET /artifacts/*
  • GET /artifactsPublications/*
  • GET /publications/*
Cite this Doc
Willighagen, Lars. 2024. “User Guides: REST API.” Cuneiform Digital Library Initiative. April 24, 2024. https://cdli.mpiwg-berlin.mpg.de/docs/api.
Willighagen, L. (2024, April 24). User guides: REST API. Cuneiform Digital Library Initiative. https://cdli.mpiwg-berlin.mpg.de/docs/api
Willighagen, L. (2024) User guides: REST API, Cuneiform Digital Library Initiative. Available at: https://cdli.mpiwg-berlin.mpg.de/docs/api (Accessed: April 24, 2024).
@misc{Willighagen2024User,
	note = {[Online; accessed 2024-04-24]},
	author = {Willighagen, Lars},
	year = {2024},
	month = {apr 24},
	title = {User guides: REST {API}},
	url = {https://cdli.mpiwg-berlin.mpg.de/docs/api},
	howpublished = {https://cdli.mpiwg-berlin.mpg.de/docs/api},
}

TY  - ELEC
AU  - Willighagen, Lars
DA  - 2024/4/24/
PY  - 2024
ID  - temp_id_429652163103
M1  - 2024/4/24/
TI  - User guides: REST API
UR  - https://cdli.mpiwg-berlin.mpg.de/docs/api
ER  - 
This website uses essential cookies that are necessary for it to work properly. These cookies are enabled by default.