Foundationspecstableimplmature
Essenzielle Funktionalität, API-Katalog mit allen veröffentlichten APIs.
Umfang
Konfiguration
Stellt Basis-Funktionalität für alle anderen Module bereit und kann daher nicht deaktiviert werden.
Optionen
Name | Default | Beschreibung | Typ | Seit |
---|---|---|---|---|
buildingBlock | Immer FOUNDATION . | string | v2.0 | |
extensionType | Deprecated Siehe buildingBlock . | string | v2.0 | |
enabled | true | Soll das Modul aktiviert werden? | boolean | v2.0 |
useLangParameter | false | Steuert, ob die Sprache der Antwort bei allen GET-Operationen nur über den Accept-Lang -Header oder auch über einen Parameter lang ausgewählt werden kann. | boolean | v2.0 |
includeLinkHeader | true | Steuert, ob die in Antworten der API enthaltenen Links auch als HTTP-Header zurückgegeben werden. | boolean | v2.0 |
apiCatalogLabel | API Overview | Titel für die API-Catalog-Ressource in diesem Deployment. | string | v2.0 |
apiCatalogDescription | The following OGC Web APIs are available. | Beschreibung für die API-Catalog-Ressource in diesem Deployment. HTML-Markup wird bei der HTML-Ausgabe aufbereitet. | string | v2.0 |
googleSiteVerification | null | Sofern gesetzt, wird der Wert in die HTML-Seite des API-Catalog-Ressource in einem "googleSiteVerification"-Meta-Tag eingebettet ( <meta name=" google-site-verification`" content="{value}" >). | string | v2.0 |
includeSpecificationInformation | false | Steuert, ob Informationen (Name, Link, Reifegrad) über die Spezifikation einer API-Komponente, z.B. eine Operation oder ein Query-Parameter, in die API-Definition aufgenommen werden. Es wird empfohlen, diese Option zu aktivieren, wenn die API Module enthält, die nicht als stable gekennzeichnet sind. | boolean | v2.0 |
Beispiele
Das Schema der API-Catalog-Ressource ist:
type: object
required:
- apis
properties:
title:
type: string
description:
type: string
apis:
type: array
items:
type: object
required:
- title
- landingPageUri
properties:
title:
type: string
description:
type: string
landingPageUri:
type: string
format: uri
Example of the specifications in the configuration file:
Beispiel für die Angaben in der Konfigurationsdatei:
- buildingBlock: FOUNDATION
includeLinkHeader: true
useLangParameter: false
apiCatalogLabel: 'Demonstration APIs using ldproxy'
apiCatalogDescription: 'The APIs below are available as examples for Web APIs that can be set up with <a href="https://github.com/interactive-instruments/ldproxy" >ldproxy</a>.'