NDE Datasetregister

Basisadres

https://datasetregister.netwerkdigitaalerfgoed.nl/sparql

Endpoints 7

• GET/sparql?query=…SPARQL-vraag in de URL. Met Accept: application/json of application/sparql-results+json het standaard-JSON, text/csv een tabel. Het antwoord heeft ook meta.query-time-ms.
• POST/sparqlDezelfde vraag als formulierveld query= (handig voor lange vragen).
• GET/api/datasets?url=…REST: staat een beschrijving op dit adres al in het register?
• POST/api/datasetsREST: een datasetbeschrijving aanmelden (voor instellingen; zie allowed-domains).
• POST/api/datasets/validateREST: een beschrijving in de body valideren tegen de NDE-eisen; PUT met een URL valideert wat op dat adres staat.
• GET/api/shaclREST: de SHACL-vorm waarmee beschrijvingen worden gecontroleerd.
• GET/api/allowed-domains?url=…REST: staat het domein op de lijst van toegestane domeinen?

Filteren getest

SPARQL 1.1 met prefixes dcat: <http://www.w3.org/ns/dcat#>, dct: <http://purl.org/dc/terms/>, schema: <https://schema.org/> (https). FILTER(CONTAINS(LCASE(?titel), "…")) om op tekst te zoeken.

Parameters 3

Predicaten van een dataset en zijn distributies (selectie) 14

Limieten en valkuilen

• Geen gedocumenteerde limiet of sleutel. Tellingen over het hele register duurden 50 tot 70 ms. getest
• robots.txt verbiedt alleen search.php, show.php en viaurl.php van de oude app; /sparql en /api mogen. getest
• Tel alleen geldige registraties (schema:subjectOf/schema:additionalType …/registry/valid): 3.392 op 16 okt 2026 rond 23:45, terwijl de dag eerder 3.401 gaf. Het aantal schommelt doordat het register beschrijvingen steeds opnieuw ophaalt. getest
• schema: is hier https://schema.org/ (https), dct: is http://purl.org/dc/terms/ (met schuine streep). Anders dan bij de KB. getest
• Elke aangemelde beschrijving staat in een eigen graaf (het adres van de registratie); daarnaast grafen met registraties, beoordelingen, SHACL-uitkomsten en de bereikbaarheid van distributies (…/sparql/distribution-health). getest
• Licenties per URI tellen: CC0 staat er als http:// (1.063) én https:// (34). Normaliseer voor je optelt. getest
• Het register bevat beschrijvingen, geen collectiedata: de data haal je bij de instelling via dcat:accessURL of dcat:downloadURL. uit de beschrijving

Probeer het HTTP 200 · 391 ms · 16 okt

https://datasetregister.netwerkdigitaalerfgoed.nl/sparql?query=PREFIX dcat%3A <http%3A%2F%2Fwww.w3.org%2Fns%2Fdcat%23> PREFIX dct%3A <http%3A%2F%2Fpurl.org%2Fdc%2Fterms%2F> PREFIX schema%3A <https%3A%2F%2Fschema.org%2F> SELECT %3Flicentie (COUNT(DISTINCT %3Fd) AS %3Fdatasets) WHERE { %3Fd a dcat%3ADataset %3B dct%3Alicense %3Flicentie %3B schema%3AsubjectOf%2Fschema%3AadditionalType <https%3A%2F%2Fdata.netwerkdigitaalerfgoed.nl%2Fregistry%2Fvalid> } GROUP BY %3Flicentie ORDER BY DESC(%3Fdatasets) LIMIT 5

{
  "head": {
    "vars": [
      "licentie",
      "datasets"
    ]
  },
  "results": {
    "bindings": [
      {
        "licentie": {
          "type": "uri",
          "value": "http://creativecommons.org/licenses/by/4.0/"
        },
        "datasets": {
          "datatype": "http://www.w3.org/2001/XMLSchema#int",
          "type": "literal",
          "value": "1832"
        }
      },
      {
        "licentie": {
          "type": "uri",
          "value": "http://creativecommons.org/publicdomain/zero/1.0/"
        },
        "datasets": {
          "datatype": "http://www.w3.org/2001/XMLSchema#int",
          "type": "literal",
          "value": "1063"
        }
      }
    ]
  },
  "meta": {
    "query-time-ms": 42,
    "result-size-total": 5
  }
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.