Ingest

Ingest


Führt einen Ingest in ein Vokabular durch.
Es wird ein valides, urlencodiertes JSKOS erwartet. Die Datensätze sind nach dem Ingest als "veröffentlicht" getaggt und können direkt genutzt werden.

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)\" } }]"
}]
data (obligatorisch), username (obligatorisch), token (obligatorisch)

Möglich sind im Ingest-JSKOS:
Username und Token gelten jeweils nur für ein Vokabular und werden vom Betreiber verteilt. Die Uploads können per Konfiguration pro Vokabular per IP in der Anzahl pro Minute / Stunde / Tag begrenzt werden. Die jeweils eingetragene 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/96bfa7d6-67ed-4e8e-b79d-8599a8a347ce",
        "type": [
            "http://www.w3.org/2004/02/skos/core#Concept"
        ],
        "@context": "https://gbv.github.io/jskos/context.json",
        "inScheme": [
            {
                "uri": "http://uri.gbv.de/terminology/test/",
                "prefLabel": {
                    "de": "Testpool",
                    "en": "Testpool"
                },
                "type": [
                    "http://www.w3.org/2004/02/skos/core#ConceptScheme",
                    "http://w3id.org/nkos/nkostype#name_authority_list"
                ],
                "notation": [
                    "test"
                ],
                "license": [
                    {
                        "uri": "http://www.wtfpl.net/",
                        "notation": [
                            "WTFPL"
                        ],
                        "prefLabel": {
                            "en": "Do What the Fuck You Want to Public License"
                        }
                    }
                ]
            }
        ],
        "created": "2026-02-09",
        "issued": "2026-02-09",
        "modified": "2026-02-09",
        "publisher": [
            {
                "prefLabel": {
                    "de": "Lustiger Testherausgeber"
                }
            }
        ],
        "mappings": [
            {
                "type": [
                    "http://www.w3.org/2004/02/skos/core#exactMatch"
                ],
                "from": {
                    "memberSet": [
                        {
                            "uri": "http://uri.gbv.de/terminology/test/96bfa7d6-67ed-4e8e-b79d-8599a8a347ce"
                        }
                    ]
                },
                "to": {
                    "memberSet": [
                        {
                            "uri": "exampleID"
                        }
                    ]
                }
            }
        ],
        "notation": [
            "x01_identifier_02"
        ],
        "prefLabel": {
            "de": "Test (deutsch)",
            "en": "Test (english)"
        },
        "topConceptOf": [
            {
                "uri": "http://uri.gbv.de/terminology/test/",
                "prefLabel": {
                    "de": "Testpool"
                },
                "type": [
                    "http://www.w3.org/2004/02/skos/core#ConceptScheme",
                    "http://w3id.org/nkos/nkostype#name_authority_list"
                ],
                "notation": [
                    "test"
                ]
            }
        ],
        "broader": [],
        "ancestors": [],
        "narrower": [],
        "qualifiedLiterals": {
            "http://www.w3.org/2004/02/skos/core#notation": [
                {
                    "literal": {
                        "string": "x01_identifier_02",
                        "language": "und"
                    },
                    "type": [
                        "http://www.w3.org/2008/05/skos-xl#Label",
                        "http://uri.gbv.de/terminology/signature_type/1c03ea24-f28a-4c69-9121-bb0e67e4b166"
                    ],
                    "rank": "normal"
                }
            ],
            "http://www.w3.org/2008/05/skos-xl#prefLabel": [
                {
                    "type": [
                        "http://www.w3.org/2008/05/skos-xl#Label"
                    ],
                    "literal": {
                        "string": "Test (deutsch)",
                        "language": "de"
                    },
                    "rank": "preferred"
                },
                {
                    "type": [
                        "http://www.w3.org/2008/05/skos-xl#Label"
                    ],
                    "literal": {
                        "string": "Test (english)",
                        "language": "en"
                    },
                    "rank": "normal"
                }
            ]
        }
    }
]