Ingest
Diese Seite beschreibt den möglichen Ingest von Datensätzen über die API.
Ingest
Führt einen Ingest in ein Vokabular durch. Es wird ein valides, urlencodiertes JSKOS erwartet.
POST /ingest
Requestbody als JSON
[{
"username": "testuser",
"token": "3929b8d9-e618-455f-bfdf-4dff475c32b0",
"data": "[{ \"type\": [\"http:\\/\\/www.w3.org\\/2004\\/02\\/skos\\/core#Concept\"], \"inScheme\": [{ \"uri\": \"http:\\/\\/uri.gbv.de\\/terminology\\/test\\/\" }], \"identifier\": [\"exampleID\"], \"notation\": [\"x01_identifier_02\"], \"prefLabel\": { \"de\": \"Test (deutsch)\", \"en\": \"Test (english)\" } }]"
}]
Möglich sind im Ingest-JSKOS:
- inScheme (Pflicht)
- type
- notation
- identifier
- prefLabel (Pflicht "de")
- altLabel
- hiddenLabel
- note
- definition
- editorialNote
- changeNote
- scopeNote
- example
- historyNote
Username und Token gelten jeweils nur für ein Vokabular und sind geheim. Die Uploads können pro Vokabular per IP in der Anzahl pro Minute / Stunde / Tag begrenzt sein. Die entsprechende Vokabularredaktion wird per E-Mail über den neuen Datensatz in Kenntnis gesetzt. Hierarchien und weitere Spezialisierungen müssen in DANTE selbst vorgenommen werden.
Rückgabe im JSKOS-Format
[
{
"uri": "http://uri.gbv.de/terminology/test/4e3e165d-dff6-45cc-a150-8b6fcf84f176",
"type": [
"http://www.w3.org/2004/02/skos/core#Concept"
],
"@context": "http://gbv.github.io/jskos/context.json",
"inScheme": [
{
"uri": "http://uri.gbv.de/terminology/test/",
"prefLabel": {
"de": "Testpool"
}
}
],
"modified": "2018-09-26",
"publisher": [
{
"prefLabel": {
"de": "Lustiger Testherausgeber"
}
}
],
"license": [
{
"uri": "http://www.wtfpl.net/",
"notation": [
"WTFPL"
],
"prefLabel": {
"en": "Do What the Fuck You Want to Public License"
}
}
],
"identifier": [
"exampleID"
],
"mapping": [
{
"type": "http://www.w3.org/2004/02/skos/core#exactMatch",
"from": "http://uri.gbv.de/terminology/test/4e3e165d-dff6-45cc-a150-8b6fcf84f176",
"to": "exampleID"
}
],
"notation": [
"x01_identifier_02"
],
"prefLabel": {
"de": "Test (deutsch)",
"en": "Test (english)"
},
"topConceptOf": [
{
"uri": "http://uri.gbv.de/terminology/test/",
"prefLabel": {
"de": "Testpool"
}
}
],
"broader": [],
"ancestors": [],
"narrower": []
}
]