mirror of
https://bitbucket.org/myhomie/mycorerepository.git
synced 2025-12-06 09:41:19 +00:00
508 lines
14 KiB
Markdown
508 lines
14 KiB
Markdown
# mycoreapi.api.DeviceApi
|
|
|
|
## Load the API package
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
```
|
|
|
|
All URIs are relative to *http://localhost:25049*
|
|
|
|
Method | HTTP request | Description
|
|
------------- | ------------- | -------------
|
|
[**deviceCreate**](DeviceApi.md#devicecreate) | **POST** /api/device | Create a device
|
|
[**deviceCreateDevicesFromProvider**](DeviceApi.md#devicecreatedevicesfromprovider) | **POST** /api/device/{userId}/fromProvider/{providerId} | Create devices from provider
|
|
[**deviceDelete**](DeviceApi.md#devicedelete) | **DELETE** /api/device/{deviceId} | Delete a device
|
|
[**deviceDeleteAllForUser**](DeviceApi.md#devicedeleteallforuser) | **DELETE** /api/device/user/{userId} | Delete all device for a specified user
|
|
[**deviceDeleteDevicesFromProvider**](DeviceApi.md#devicedeletedevicesfromprovider) | **DELETE** /api/device/{userId}/fromProvider/{providerId} | Delete devices from provider
|
|
[**deviceGetAll**](DeviceApi.md#devicegetall) | **GET** /api/device/{userId} | Get all devices summary
|
|
[**deviceGetDetail**](DeviceApi.md#devicegetdetail) | **GET** /api/device/detail/{deviceId} | Get a specific device info
|
|
[**deviceGetDevicesByType**](DeviceApi.md#devicegetdevicesbytype) | **GET** /api/device/{userId}/type/{type} | Get list of devices from a type
|
|
[**deviceGetDevicesFromProvider**](DeviceApi.md#devicegetdevicesfromprovider) | **GET** /api/device/{userId}/fromProvider/{providerId} | Get devices from provider
|
|
[**deviceGetDevicesFromZigbee2Mqtt**](DeviceApi.md#devicegetdevicesfromzigbee2mqtt) | **GET** /api/device/zigbee2Mqtt/{userId} | Get all zigbee2Mqtt devices
|
|
[**deviceUpdate**](DeviceApi.md#deviceupdate) | **PUT** /api/device/{deviceId} | Update a device
|
|
|
|
|
|
# **deviceCreate**
|
|
> DeviceDetailDTO deviceCreate(deviceDetailDTO)
|
|
|
|
Create a device
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final deviceDetailDTO = DeviceDetailDTO(); // DeviceDetailDTO | Device to create
|
|
|
|
try {
|
|
final result = api_instance.deviceCreate(deviceDetailDTO);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceCreate: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**deviceDetailDTO** | [**DeviceDetailDTO**](DeviceDetailDTO.md)| Device to create |
|
|
|
|
### Return type
|
|
|
|
[**DeviceDetailDTO**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: application/json
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceCreateDevicesFromProvider**
|
|
> List<DeviceDetailDTO> deviceCreateDevicesFromProvider(userId, providerId)
|
|
|
|
Create devices from provider
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | User Id
|
|
final providerId = providerId_example; // String | Id of Provider
|
|
|
|
try {
|
|
final result = api_instance.deviceCreateDevicesFromProvider(userId, providerId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceCreateDevicesFromProvider: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| User Id |
|
|
**providerId** | **String**| Id of Provider |
|
|
|
|
### Return type
|
|
|
|
[**List<DeviceDetailDTO>**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceDelete**
|
|
> String deviceDelete(deviceId)
|
|
|
|
Delete a device
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final deviceId = deviceId_example; // String | Id of device to delete
|
|
|
|
try {
|
|
final result = api_instance.deviceDelete(deviceId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceDelete: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**deviceId** | **String**| Id of device to delete |
|
|
|
|
### Return type
|
|
|
|
**String**
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceDeleteAllForUser**
|
|
> String deviceDeleteAllForUser(userId)
|
|
|
|
Delete all device for a specified user
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | Id of user
|
|
|
|
try {
|
|
final result = api_instance.deviceDeleteAllForUser(userId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceDeleteAllForUser: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| Id of user |
|
|
|
|
### Return type
|
|
|
|
**String**
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceDeleteDevicesFromProvider**
|
|
> String deviceDeleteDevicesFromProvider(userId, providerId)
|
|
|
|
Delete devices from provider
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | User Id
|
|
final providerId = providerId_example; // String | Id of Provider
|
|
|
|
try {
|
|
final result = api_instance.deviceDeleteDevicesFromProvider(userId, providerId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceDeleteDevicesFromProvider: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| User Id |
|
|
**providerId** | **String**| Id of Provider |
|
|
|
|
### Return type
|
|
|
|
**String**
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceGetAll**
|
|
> List<DeviceSummaryDTO> deviceGetAll(userId)
|
|
|
|
Get all devices summary
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | Id of user
|
|
|
|
try {
|
|
final result = api_instance.deviceGetAll(userId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceGetAll: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| Id of user |
|
|
|
|
### Return type
|
|
|
|
[**List<DeviceSummaryDTO>**](DeviceSummaryDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceGetDetail**
|
|
> DeviceDetailDTO deviceGetDetail(deviceId)
|
|
|
|
Get a specific device info
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final deviceId = deviceId_example; // String | id of device
|
|
|
|
try {
|
|
final result = api_instance.deviceGetDetail(deviceId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceGetDetail: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**deviceId** | **String**| id of device |
|
|
|
|
### Return type
|
|
|
|
[**DeviceDetailDTO**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceGetDevicesByType**
|
|
> List<DeviceDetailDTO> deviceGetDevicesByType(userId, type)
|
|
|
|
Get list of devices from a type
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | user Id
|
|
final type = ; // DeviceType | device type
|
|
|
|
try {
|
|
final result = api_instance.deviceGetDevicesByType(userId, type);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceGetDevicesByType: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| user Id |
|
|
**type** | [**DeviceType**](.md)| device type |
|
|
|
|
### Return type
|
|
|
|
[**List<DeviceDetailDTO>**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceGetDevicesFromProvider**
|
|
> List<DeviceDetailDTO> deviceGetDevicesFromProvider(userId, providerId)
|
|
|
|
Get devices from provider
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | User Id
|
|
final providerId = providerId_example; // String | Id of Provider
|
|
|
|
try {
|
|
final result = api_instance.deviceGetDevicesFromProvider(userId, providerId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceGetDevicesFromProvider: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| User Id |
|
|
**providerId** | **String**| Id of Provider |
|
|
|
|
### Return type
|
|
|
|
[**List<DeviceDetailDTO>**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceGetDevicesFromZigbee2Mqtt**
|
|
> List<DeviceDetailDTO> deviceGetDevicesFromZigbee2Mqtt(userId)
|
|
|
|
Get all zigbee2Mqtt devices
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final userId = userId_example; // String | User Id
|
|
|
|
try {
|
|
final result = api_instance.deviceGetDevicesFromZigbee2Mqtt(userId);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceGetDevicesFromZigbee2Mqtt: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**userId** | **String**| User Id |
|
|
|
|
### Return type
|
|
|
|
[**List<DeviceDetailDTO>**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: Not defined
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|
|
# **deviceUpdate**
|
|
> DeviceDetailDTO deviceUpdate(deviceId, deviceDetailDTO)
|
|
|
|
Update a device
|
|
|
|
### Example
|
|
```dart
|
|
import 'package:mycoreapi/api.dart';
|
|
// TODO Configure OAuth2 access token for authorization: bearer
|
|
//defaultApiClient.getAuthentication<OAuth>('bearer').accessToken = 'YOUR_ACCESS_TOKEN';
|
|
|
|
final api_instance = DeviceApi();
|
|
final deviceId = deviceId_example; // String |
|
|
final deviceDetailDTO = DeviceDetailDTO(); // DeviceDetailDTO | Device to update
|
|
|
|
try {
|
|
final result = api_instance.deviceUpdate(deviceId, deviceDetailDTO);
|
|
print(result);
|
|
} catch (e) {
|
|
print('Exception when calling DeviceApi->deviceUpdate: $e\n');
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
Name | Type | Description | Notes
|
|
------------- | ------------- | ------------- | -------------
|
|
**deviceId** | **String**| |
|
|
**deviceDetailDTO** | [**DeviceDetailDTO**](DeviceDetailDTO.md)| Device to update |
|
|
|
|
### Return type
|
|
|
|
[**DeviceDetailDTO**](DeviceDetailDTO.md)
|
|
|
|
### Authorization
|
|
|
|
[bearer](../README.md#bearer)
|
|
|
|
### HTTP request headers
|
|
|
|
- **Content-Type**: application/json
|
|
- **Accept**: application/json
|
|
|
|
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
|
|
|