| Titel | Der Titel des Eintrags ist kurz und macht die elektronische Schnittstelle einfach auffindbar. Der Titel besteht aus einer Zeichenkette, darf also Buchstaben, Sonderzeichen und Zahlen enthalten. Der Titel kann in den Sprachen Deutsch, Französisch, Italienisch und Englisch hinterlegt werden. Zwingend nötig ist der Titel in einer Sprache; für Metadaten des Bundes sollten die Titel mindestens in Deutsch, Französisch und Italienisch vorliegen. Via die API ist es möglich zusätzlich einen Titel in Rätoromanisch abzuspeichern. | dct:title | rdfs:Literal | 1..1 | obligatorisch | DCAT-AP CH 2.0 |
| Beschreibung | In diesem Feld wird die API möglichst präzise in Freitext in der betreffenden Sprache beschrieben. Idealerweise enthält die Beschreibung alle Begriffe, nach denen vermutlich gesucht wird. Absätze sind möglich, Textformatierungen aber nicht. Die Beschreibung kann in den Sprachen Deutsch, Französisch, Italienisch und Englisch hinterlegt werden. Es ist anzustreben, dass die Beschreibung in mehreren Sprachen vorliegt; Angaben in mindestens einer Sprache sind obligatorisch. Via die API ist es möglich zusätzlich eine Beschreibung in Rätoromanisch abzuspeichern. | dct:description | rdfs:Literal | 1..1 | obligatorisch | DCAT-AP CH 2.0 |
| Herausgeber | Als Herausgeber wird jene Organisation aufgeführt, die der Datensatz in Auftrag gegeben hat oder sie pflegt. Auswählbar ist die eigene Organisation beziehungsweise die eigenen Organisationen. Eingeblendet werden jene Organisationen, in denen die betreffende Person Schreibrechte hat. | dct:publisher | foaf:Agent | 1..1 | obligatorisch | DCAT-AP CH 2.0 |
| Zugriffsrechte | Bitte geben Sie an, ob die Daten, die von der API zugänglich gemacht werden, frei und kostenlos verfügbar ist (“Öffentlich”), ob sie unter bestimmten Bedingungen genutzt werden kann (“Eingeschränkt”) oder ob sie ausschliesslich Ihrer Organisation zur Verfügung steht (“Nicht-öffentlich”). Die Optionen stammen aus einem Vokabular der Europäischen Union. | dct:accessRights | dct:RightsStatement | 1..1 | obligatorisch | DCAT-AP CH 2.0 |
| URL des Endpunktes | Internetadresse und Titel des primären Endpunktes der API. Wenn Sie den Titel ausfüllen, wird auf der Plattform der verlinkte Titel eingeblendet. Wird es leer gelassen, erscheint die volle Internetadressen. Bei einer API mit zahlreichen Endpunkten empfiehlt es sich, hier den Link zur Dokumentationsseite (z.B. dem Swagger) zu erfassen. Es ist aber grundsätzlich auch möglich, auf der Plattform mehrere Endpunkte zu dokumentieren. | dcat:endpointURL | rdfs:Resource | 1..n | obligatorisch | DCAT-AP CH 2.0 |
| Beschreibung des Endpunktes | Verlinken Sie die Beschreibungen bzw. Dokumentationen der einzelnen Endpunkte. Die Reihenfolge korrespondiert mit jener im Bereich “URL des Endpunktes”. | dcat:endpointDescription | rdfs:Resource | 0..n | erwünscht | DCAT-AP CH 2.0 |
| Kontaktstelle: Organisation | In diesem Feld wird der Name der Organisation erfasst, also etwa der Name des Amtes, der Sektion oder der Gemeinde. Der Name wie auch die Anschrift der Kontaktstelle können mehrsprachig hinterlegt werden. Zudem ist es möglich, mehrere Kontaktstellen zu erfassen. | Teil von dcat:contactPoint | vcard:Kind | 0..n | erwünscht | DCAT-AP CH 2.0 |
| Kontaktstelle: Adresse | In diesem Feld wird die Adresse der Organisation erfasst. Erwünscht ist der Name der Strasse und die Hausnummer, auf der nächsten Zeile – sofern zutreffend – Angaben zum Postfach und schliesslich die Postleitzahl gefolgt vom Ort. | Teil von dcat:contactPoint | vcard:Kind | 0..n | erwünscht | DCAT-AP CH 2.0 |
| Kontaktstelle: Notiz | In diesem Feld können allfällige präzisierende oder aber zusätzliche Angaben zur Kontaktstelle erfasst werden. | Teil von dcat:contactPoint | vcard:Kind | 0..n | erwünscht | DCAT-AP CH 2.0 |
| Kontaktstelle: E-Mail | Zwingend zu erfassen ist die E-Mail-Adresse, über die die Organisation erreicht werden kann. Diese Adresse wird idealerweise täglich überwacht. Es ist möglich, mehrere Kontaktstellen zu erfassen. | Teil von dcat:contactPoint | vcard:Kind | 1..n | erwünscht | DCAT-AP CH 2.0 |
| Kontaktstelle: Telefon | Die Telefonnummer für Rückfragen zum betreffenden Datenangebot wird im Format +41 XXX XX XX hinterlegt. | Teil von dcat:contactPoint | vcard:Kind | 0..n | erwünscht | DCAT-AP CH 2.0 |
| Themen | In diesem Feld wird angegeben, aus welchen thematischen Bereichen Daten zur Verfügung gestellt werden. Die hier gemachten Angaben bilden die Grundlage für einige Filtermöglichkeiten auf der Interoperabilitätsplattform I14Y. Hinterlegt ist eine Themenliste, die auch als Konzept auf der Interoperabilitätsplattform I14Y verfügbar ist. Die Liste wurde vom Normierungsgremium eCH entwickelt und im Dokument zu den Grundlagen für die E-Government-Architektur der Schweiz publiziert (eCH-0122). Die Interoperabilitätsstelle hat die Liste leicht erweitert. Die zusätzlichen Begriffe sollen in die nächste Version des eCH-Dokuments aufgenommen werden. Für die Publikation auf opendata.swiss ist zusätzlich ein Thema aus der dort verwendeten Themenliste auszuwählen. | dcat:theme | skos:Concept | 0..n | optional | DCAT-AP CH 2.0 |
| Lizenz | Wählen Sie die Lizenz aus, unter der die über die elektronische Schnittstelle abrufbaren Daten stehen. Das Lizenzfeld muss zwingend ausgefüllt werden, falls die Metadaten auf opendata.swiss veröffentlicht werden sollen. Hinterlegt ist die von eCH erarbeitete Liste mit Lizenzen für Open Government Data. Die Lizenzliste ist auf der Interoperabilitätsplattform I14Y als Konzept verfügbar. | dct:license | dct:LicenseDocument | 0..1 | erwünscht | DCAT-AP CH 2.0 |
| Schlüsselwörter | Damit der Eintrag einfach auffindbar wird, lassen sich Schlüsselwörter hinterlegen. Das Feld sollte insbesondere für jene Begriffe genutzt werden, die in der Termdat-Datenbank des Bundes, dem europäischen Umwelt-Thesaurus GEMET oder der kollaborativen Datenplattform Wikidata verzeichnet sind. Nebst dem Begriff in den Landessprachen sowie in Englisch lässt sich die URI zum betreffenden Objekt auf Termdat, Gemet oder Wikidata hinterlegen. | dcat:keyword | rdfs:Literal | 0..n | erwünscht | DCAT-AP CH 2.0 |
| Landing page | Tragen Sie hier den Link zu jener Webseite bei Ihrer Organisation ein, auf welcher die API detailliert beschrieben wird. | dcat:landingPage | foaf:Document | 0..n | optional | DCAT-AP CH 2.0 |
| Konform zu | Setzen Sie einen Link auf das entsprechende Dokument, wenn Ihr Datenangebot einem Standard entspricht. | dct:conformsTo | dct:Standard | 0..n | optional | DCAT-AP CH 3.0 (Working Draft) |
| Dokumente | Tragen Sie hier weitere Dokumente ein, die einen direkten Zusammenhang mit ihrem Angebot haben, etwa eine Anleitung oder einen Hintergrundtext. | foaf:page | foaf:Document | 0..n | optional | DCAT-AP CH 2.0 |
| Verwendeter Datensatz | Geben Sie hier an, welche Datensätze über diese API zugänglich gemacht werden. Dies ermöglicht es, die Verbindung zwischen dem Data Service und den entsprechenden Datasets zu dokumentieren. | dcat:servesDataset | dcat:Dataset | 0..n | erwünscht | DCAT-AP CH 3.0 (Working Draft) |
| Version | Tragen Sie hier die Versionsnummer Ihrer API ein. Bei Neueröffnung eines Eintrags wird die Versionsnummer 1.0.0 gesetzt. Bei kleineren Änderungen am Eintrag wird zur Versionsnummer 1.0.1 usw. übergegangen. Bei relevanten inhaltlichen Änderungen wird zur Versionsnummer 1.1.0 usw. übergegangen. Bei grossen Änderungen wird auf die Versionsnummer 2.0.0 gewechselt. | dcat:version | rdfs:Literal | 0..1 | optional | DCAT-AP CH 3.0 (Working Draft) |
| Versionshinweise | Erfassen Sie hier zusätzliche Informationen zur betreffenden Version. | adms:versionNotes | rdfs:Literal | 0..1 | optional | DCAT-AP CH 3.0 (Working Draft) |