Swagger (OpenAPI)

Swagger (OpenAPI)

Boligdok har udstillet API'et i swagger (OpenAPI), du kan finde det her:

Klientkode

Swagger.io kan bruges til at generere klientkode i dit foretrukne sprog. For at importere swagger-specifikationen i din editor, skal du først eksportere den som fil fra Boligdok siden. Dette gør du ved at vælge "Gem link som" her. Ved import af api-filen vil editoren gøre opmærksom på nogle semantiske fejl på Bygningssagkyndig v1. Disse ignoreres.

Swagger editoren kan være nyttig til kodegenerering i en startfase, men i et udviklingsmiljø anbefales at automatisere kodegenereringen.

Klient-koden genereres automatisk med værktøjer fra swagger-codegen. Hvis I bruger Maven findes swagger-codegen-maven-plugin. På .Net platformen er værktøjer som f.eks. NSwagtil rådighed.

Sådan bruger du API'et: