Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create PublicInformation-local-openapi-v3.yml #101

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
102 changes: 102 additions & 0 deletions openapi/PublicInformation-local-openapi-v3.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
### Generated by Eclipse Vorto OpenAPI Generator from Model 'vorto.private.local.com.bosch.sh:SmartPlug:1.0.0'
openapi: 3.0.0
info:
title: Bosch Smart Home Local API for Main Resources
description: |-
This API interface provides access to public information from the Bosch Smart Home Controller. It enables the retrieval of a list of all clients paired with the controller, including details on software updates, connectivity versions, and system properties. The API serves as a central point for querying system information essential for integrating and managing smart home devices. By utilizing this interface, developers can efficiently access crucial data to enhance the functionality and user experience of their applications.

By using this documentation, the developer accepts and agrees to be bound by our [Terms and Conditions](https://github.com/BoschSmartHome/bosch-shc-api-docs#terms-and-conditions).

This documentation is subject to the [Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International Public License](https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode).

Please report any issues you encounter with this documentation in our [GitHub tracker](https://github.com/BoschSmartHome/bosch-shc-api-docs/issues).
version: "3.6"
servers:
- url: https://{{host}}:8446/smarthome
description: "Bosch Smart Home Controller URL"
variables:
shcIp:
default: 192.168.0.10
tags:
- name: SystemInformation

paths:
###
### System Information
###
'/public/information':
get:
summary: List all available Devices.
SteffenMangold marked this conversation as resolved.
Show resolved Hide resolved
description: Returns all Devices paired with the Smart Home Controller.
SteffenMangold marked this conversation as resolved.
Show resolved Hide resolved
tags:
- SystemInformation
responses:
'200':
description: Accepted request.
content:
application/json:
schema:
$ref: '#/components/schemas/PublicInformation'

components:
schemas:
PublicInformation:
type: object
properties:
apiVersions:
type: array
items:
type: string
softwareUpdateState:
type: object
properties:
"@type":
type: string
swUpdateState:
type: string
swUpdateLastResult:
type: string
swUpdateAvailableVersion:
type: string
swInstalledVersion:
type: string
swActivationDate:
type: object
properties:
"@type":
type: string
timeout:
type: integer
automaticUpdatesEnabled:
type: boolean
macAddress:
type: string
claimed:
type: boolean
country:
type: string
tacVersion:
type: string
shcIpAddress:
type: string
clientIds:
type: array
items:
type: string
featureToggles:
type: object
additionalProperties:
type: boolean
connectivityVersions:
type: array
items:
type: object
properties:
name:
type: string
minVersion:
type: integer
maxVersion:
type: integer
shcGeneration:
type: string