fhir-openapi-gen

Preview

Please note, that in long description you should mention: • App's goals and functions • How to use the app • If it is open source app - please, provide the installation instructions

Open Exchange - is a place for developers and where they share and find useful tools for development process. If your product is made for developers needs you may also publish it on Open Exchange.

Previous value: `https://github.com/CesarDNDN/fhir-openapi`

Previous value: `fhir-openapi-gen`

Previous value: `GitHub`

Previous value: `Solutions`

Previous value: `InterSystems IRIS for Health`

Previous value: ``

Previous value: `Checked`

Previous value: `A code base for the processing and formulation of the openapi spec for fhir resources and profiles`

Previous value: `IRIS FHIR OpenAPI Spec generator Generator combines data from: * FHIR server complience statement (/metadata resource) * IRIS ^HS.FHIRServer.Meta * Definitions and examples from https://hl7.org/FHIR/ And generates fully annotated OpenAPI v3 spec for all 133 resources and one "MEGASPEC", containing all resources and schemas. There are four steps: * Generate basic swagger2 spec, based on metadata (java code from 3rd party repo) * Extract data from ^HS.FHIRServer.Meta global (object script) * Convert Swagger2 to OpenAPI 3 spec (python) * Annotate spec with data from hl7.org site, merge with data extracted from global, generate 133 resource-specific and 1 "megaspec" (python) * add examples from hl4.org to resource - specific specs (python) * * * FHIR Swagger https://github.com/rbren/fhir-swagger (see repo's README.md for instructions) Generates basic Swagger2 definition from FHIR server complience statement <server-url>/metadata !!! not in this repo source: - local IRIS instance targets: - ./fhir-swagger/iris-swagger.json ``` fhir-swagger \ --fhir_url "http://<your_base>/app/FHIR/r4" \ --conformance_path="/metadata?_format=application/json" \ --r4 \ --output ./fhir-swagger/iris-swagger.json ``` * * * Extract information from IRIS FHIR server metadata source: - ^HS.FHIRServer.Meta global targets: - ./fhir-swagger/iris-global.json - ./fhir-swagger/iris-dependencies.json ``` iris session iris zn "FHIRNAMESPACE" FHIRNAMESPACE>do ^IRISFHIRMetadata ``` * * * Convert swagger 2.0 to OpenAPI 3.0 spec Add content-type source: - ./fhir-swagger/iris-swagger.json target: - ./fhir-swagger/iris-openapi3.json ``` python3 Convert2to3/ConvertFile.py ``` * * * annotate - enhance OpenAPI definitions with descriptions from hl7.org merge with data from ^HS.FHIR.Meta global add OAuth2 security sources: - ./fhir-swagger/iris-openapi3.json - ./fhir-swagger/iris-global.json - ./fhir-swagger/iris-dependencies.json - ./definitions.json/*.json - FHIR definitions from hl7.org targets: - ./output/openapi3.json "megaspec" - ./output/<resource name>.json 133 small, resource - specific specs ``` python3 Annotate3/AnnotateFiles.py ``` * * * add payload examples to resource OpenAPI specs sources: - ./output/<resource name>.json - ./examples-json/*.json - FHIR examples from hl7.org targets: - ./output/<resource name>.json ``` python3 AddExample3/AddExamples.py ``` * * * Full process can also be run using ObjectScript Full Process/Preprocessing code ``` iris session iris zn FHIRNAMESPACE FHIRNAMESPACE> do ##class(FHIROpenAPI.Generator).Preprocess() ``` Follow preprocessing instructions ``` FHIRNAMESPACE> do ##class(FHIROpenAPI.Generator).Run() ``` * * * Additional static files: ./output/index.html, ./output/swagger-ui.html - homepage for API browser ./output/oauth2-redirect.html static html, needed for OAuth2 authentication workflow ./output/ISC-FHIR-Icon.png ISC icon `

Previous value: `https://github.com/CesarDNDN/fhir-openapi/blob/main/LICENSE`

Previous value: `https://github.com/CesarDNDN/fhir-openapi/blob/main/README.md`

Previous image: Not set