Device API

A RESTful API for managing network devices and their topology, built using Java and Spring Boot.

Overview

Device API provides endpoints for:

• Registering and managing network devices
• Querying devices by MAC address and type
• Tracking device connections and hierarchies

Runtime Requirements

• Java: JDK 25
• Docker: For running PostgreSQL in a container
• Bruno: (Optional) For API documentation and testing

Starting the application

Use script start.sh

./start.sh

Open api location

Open api spec is located in resources/openapi/api-spec.yaml

Controllers are created using open api generator.

openApiGenerate {
generatorName.set("spring")
inputSpec.set(openApiSpecUri)
outputDir.set("$buildDir/generated")
apiPackage.set("com.impactdryer.deviceapi.infrastructure.openapi")
modelPackage.set("com.impactdryer.deviceapi.infrastructure.openapi.model")
configOptions.set(
mapOf(
"useSpringBoot3" to "true",
"delegatePattern" to "true",
"performBeanValidation" to "true",
"useSwaggerUI" to "false",
"apiNameSuffix" to "",
)
)
}