OpenAPI Metadata
The openapi target generates openapi_{filename}.json for HTTP-style interfaces.
Minimum Generation Command
Section titled “Minimum Generation Command”xidlc gen --out-dir generated openapi api.idlMetadata Pragmas
Section titled “Metadata Pragmas”The generator reads the following pragmas to populate the document metadata:
package->info.titleversion->info.version
#pragma xidlc package "Smart City Public APIs"#pragma xidlc version "v2.0.0"If omitted, the generator falls back to default metadata. See
Compiler Pragmas for the full pragma reference,
including service endpoint declarations.