Upsert data

put https://proxy.opendatagermany.io/api/ts/v1/kg/things/imports

!! This endpoint currently has no transaction handling !!

This endpoints allows for bulk upserts. Existing objects in the data will be updated (delete and create) Accepts data in JSON-LD and starts the import process of the jsonld against the specified domain specification(s).
Example headers:

Key	Value
X-PUBLISHER	publisher uuid
X-DATASOURCE	datasource uuid
Content-Type	application/ld+json

Query Params

agent

string

The agent name which started the import

component

string

The component which was used to start the import

callbackUrl

uri

Callback URL where we notify about import status updates.
The call will be a POST and will contain as body the KgThingsImport

Body Params

The main entity nodes in the data need to have an attribute with which DS it has to be verified.

"https://vocab.sti2.at/ds/compliesWith": {"@id": "DS_URI" }

A valid json+ld request body example

{
  "@id": "https://example.com.com/entity/BeispielEvent1",
  "@type": "https://schema.org/Event",
  "https://schema.org/description": "Eine lange Beschreibung dieses tollen Events",
  "https://schema.org/name": "Mein Beispiel Event",
  "https://schema.org/startDate": "2021-05-16T18:00:00+02:00",
  "https://schema.org/url": "https://example.com/exampleEvent",
  "https://vocab.sti2.at/ds/compliesWith": {
    "@id": "https://semantify.it/ds/mhpmBCJJt"
  }
}

Headers

X-PUBLISHER

string

required

the publisher of the graph

X-DATASOURCE

string

required

the datasource of the graph

X-API-KEY

string

required

the api key for authentication and authorization

X-SYNCHRONOUS-EXECUTE

string

execute a rather async operation in a synchronous way ('true' or 'false')

Responses

Language


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://proxy.opendatagermany.io/api/ts/v1/kg/things/imports \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/ld+json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK returned when X-SYNCHRONOUS-EXECUTE header is true

202ACCEPTED returned when X-SYNCHRONOUS-EXECUTE header is missing or false

400when the request body is invalid

500Unexpected server error