Gesetze, Veröffentlichungen, Statistiken, Statusinformationen und andere öffentliche Ressourcen können über stabile Kennungen gefunden werden.
öffentliche Interoperabilität
Öffentliche APIs
Dokumentierte Schnittstellen können Transparenz, Überprüfung und Wiederverwendung erweitern, ohne eine API zur Autoritätsquelle zu machen oder Daten zu öffnen, die nicht öffentlich sind.
Dokumentierte SchnittstellenMaßgebliche Quelle getrenntDatenschutz als Voreinstellung
Was eine öffentliche API ermöglichen soll
Öffentliche Schnittstellen dienen dazu, bereits zur Veröffentlichung freigegebene Informationen abzufragen und zu überprüfen. Sie erweitern Zugang und Interoperabilität, werden aber nicht dadurch zur Rechtsquelle, dass sie Daten anzeigen oder übermitteln.
Antworten müssen ermöglichen, die Daten mit der zuständigen Quelle, der Version und dem Aktualisierungszeitpunkt zu verknüpfen.
Dokumentierte Formate und Verträge verringern die Abhängigkeit von einer einzelnen Schnittstelle oder Implementierung.
Öffentlicher Schnittstellenvertrag
| Bereich | Erwartete öffentliche Regel |
|---|---|
| Versionierung | Identifizierbare Versionen, dokumentierte Änderungen und vorhersehbarer Übergang. |
| Verfügbarkeit | Ziele dürfen erst veröffentlicht werden, wenn eine überprüfbare betriebliche Messung vorliegt. |
| Grenzen | Anfragelimits und Missbrauchsschutz werden dokumentiert, ohne willkürliche Diskriminierung. |
| Authentifizierung | Öffentliche Abfrage ohne Berechtigungsnachweis, wenn die Daten bereits öffentlich sind; Authentifizierung bei persönlichem oder beschränktem Umfang. |
| Datenschutz | Eine öffentliche API macht personenbezogene oder klassifizierte Daten nicht zu offenen Daten. |
| Provenienz | Die Antwort muss auf die verantwortliche institutionelle Quelle verweisen. |
Formatbeispiele — noch nicht als Dienst verfügbar
GET /public/v1/legislation/{id}
GET /public/v1/gazette/{edition}
GET /public/v1/statistics/{series}
GET /public/v1/status
POST /verify/v1/credential
Die obigen Pfade sind Organisationsbeispiele. Sie bedeuten nicht, dass diese Adressen heute veröffentlicht oder verfügbar sind.
Institutionelle Grenze: Art. 7-B erlaubt Programmierschnittstellen, den Zugang zu erweitern, stellt jedoch klar, dass sie dadurch nicht selbst institutionelle Autorität erlangen. Art. 78 verlangt Portabilität und Interoperabilität in kritischen Modulen und Diensten.
Betrieblicher Katalog noch nicht veröffentlicht
Das Portal verfügt über Daten- und Überprüfungsstrukturen, doch die aktuelle öffentliche Version stellt weder eine Candeia-API im Produktivbetrieb noch gemessene Dienstgüteniveaus bereit.