mirror of
				https://github.com/immich-app/immich.git
				synced 2025-11-03 19:29:32 -05:00 
			
		
		
		
	* chore: sort spec * chore: open api * chore(mobile): sort auditDeletes params --------- Co-authored-by: shenlong-tanwen <139912620+shalong-tanwen@users.noreply.github.com>
		
			
				
	
	
		
			247 lines
		
	
	
		
			8.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
		
			Generated
		
	
	
			
		
		
	
	
			247 lines
		
	
	
		
			8.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
		
			Generated
		
	
	
# openapi.api.ActivityApi
 | 
						|
 | 
						|
## Load the API package
 | 
						|
```dart
 | 
						|
import 'package:openapi/api.dart';
 | 
						|
```
 | 
						|
 | 
						|
All URIs are relative to */api*
 | 
						|
 | 
						|
Method | HTTP request | Description
 | 
						|
------------- | ------------- | -------------
 | 
						|
[**createActivity**](ActivityApi.md#createactivity) | **POST** /activity | 
 | 
						|
[**deleteActivity**](ActivityApi.md#deleteactivity) | **DELETE** /activity/{id} | 
 | 
						|
[**getActivities**](ActivityApi.md#getactivities) | **GET** /activity | 
 | 
						|
[**getActivityStatistics**](ActivityApi.md#getactivitystatistics) | **GET** /activity/statistics | 
 | 
						|
 | 
						|
 | 
						|
# **createActivity**
 | 
						|
> ActivityResponseDto createActivity(activityCreateDto)
 | 
						|
 | 
						|
 | 
						|
 | 
						|
### Example
 | 
						|
```dart
 | 
						|
import 'package:openapi/api.dart';
 | 
						|
// TODO Configure API key authorization: cookie
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure API key authorization: api_key
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure HTTP Bearer authorization: bearer
 | 
						|
// Case 1. Use String Token
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken('YOUR_ACCESS_TOKEN');
 | 
						|
// Case 2. Use Function which generate token.
 | 
						|
// String yourTokenGeneratorFunction() { ... }
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);
 | 
						|
 | 
						|
final api_instance = ActivityApi();
 | 
						|
final activityCreateDto = ActivityCreateDto(); // ActivityCreateDto | 
 | 
						|
 | 
						|
try {
 | 
						|
    final result = api_instance.createActivity(activityCreateDto);
 | 
						|
    print(result);
 | 
						|
} catch (e) {
 | 
						|
    print('Exception when calling ActivityApi->createActivity: $e\n');
 | 
						|
}
 | 
						|
```
 | 
						|
 | 
						|
### Parameters
 | 
						|
 | 
						|
Name | Type | Description  | Notes
 | 
						|
------------- | ------------- | ------------- | -------------
 | 
						|
 **activityCreateDto** | [**ActivityCreateDto**](ActivityCreateDto.md)|  | 
 | 
						|
 | 
						|
### Return type
 | 
						|
 | 
						|
[**ActivityResponseDto**](ActivityResponseDto.md)
 | 
						|
 | 
						|
### Authorization
 | 
						|
 | 
						|
[cookie](../README.md#cookie), [api_key](../README.md#api_key), [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)
 | 
						|
 | 
						|
# **deleteActivity**
 | 
						|
> deleteActivity(id)
 | 
						|
 | 
						|
 | 
						|
 | 
						|
### Example
 | 
						|
```dart
 | 
						|
import 'package:openapi/api.dart';
 | 
						|
// TODO Configure API key authorization: cookie
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure API key authorization: api_key
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure HTTP Bearer authorization: bearer
 | 
						|
// Case 1. Use String Token
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken('YOUR_ACCESS_TOKEN');
 | 
						|
// Case 2. Use Function which generate token.
 | 
						|
// String yourTokenGeneratorFunction() { ... }
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);
 | 
						|
 | 
						|
final api_instance = ActivityApi();
 | 
						|
final id = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | 
 | 
						|
 | 
						|
try {
 | 
						|
    api_instance.deleteActivity(id);
 | 
						|
} catch (e) {
 | 
						|
    print('Exception when calling ActivityApi->deleteActivity: $e\n');
 | 
						|
}
 | 
						|
```
 | 
						|
 | 
						|
### Parameters
 | 
						|
 | 
						|
Name | Type | Description  | Notes
 | 
						|
------------- | ------------- | ------------- | -------------
 | 
						|
 **id** | **String**|  | 
 | 
						|
 | 
						|
### Return type
 | 
						|
 | 
						|
void (empty response body)
 | 
						|
 | 
						|
### Authorization
 | 
						|
 | 
						|
[cookie](../README.md#cookie), [api_key](../README.md#api_key), [bearer](../README.md#bearer)
 | 
						|
 | 
						|
### HTTP request headers
 | 
						|
 | 
						|
 - **Content-Type**: Not defined
 | 
						|
 - **Accept**: Not defined
 | 
						|
 | 
						|
[[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)
 | 
						|
 | 
						|
# **getActivities**
 | 
						|
> List<ActivityResponseDto> getActivities(albumId, assetId, level, type, userId)
 | 
						|
 | 
						|
 | 
						|
 | 
						|
### Example
 | 
						|
```dart
 | 
						|
import 'package:openapi/api.dart';
 | 
						|
// TODO Configure API key authorization: cookie
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure API key authorization: api_key
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure HTTP Bearer authorization: bearer
 | 
						|
// Case 1. Use String Token
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken('YOUR_ACCESS_TOKEN');
 | 
						|
// Case 2. Use Function which generate token.
 | 
						|
// String yourTokenGeneratorFunction() { ... }
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);
 | 
						|
 | 
						|
final api_instance = ActivityApi();
 | 
						|
final albumId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | 
 | 
						|
final assetId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | 
 | 
						|
final level = ; // ReactionLevel | 
 | 
						|
final type = ; // ReactionType | 
 | 
						|
final userId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | 
 | 
						|
 | 
						|
try {
 | 
						|
    final result = api_instance.getActivities(albumId, assetId, level, type, userId);
 | 
						|
    print(result);
 | 
						|
} catch (e) {
 | 
						|
    print('Exception when calling ActivityApi->getActivities: $e\n');
 | 
						|
}
 | 
						|
```
 | 
						|
 | 
						|
### Parameters
 | 
						|
 | 
						|
Name | Type | Description  | Notes
 | 
						|
------------- | ------------- | ------------- | -------------
 | 
						|
 **albumId** | **String**|  | 
 | 
						|
 **assetId** | **String**|  | [optional] 
 | 
						|
 **level** | [**ReactionLevel**](.md)|  | [optional] 
 | 
						|
 **type** | [**ReactionType**](.md)|  | [optional] 
 | 
						|
 **userId** | **String**|  | [optional] 
 | 
						|
 | 
						|
### Return type
 | 
						|
 | 
						|
[**List<ActivityResponseDto>**](ActivityResponseDto.md)
 | 
						|
 | 
						|
### Authorization
 | 
						|
 | 
						|
[cookie](../README.md#cookie), [api_key](../README.md#api_key), [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)
 | 
						|
 | 
						|
# **getActivityStatistics**
 | 
						|
> ActivityStatisticsResponseDto getActivityStatistics(albumId, assetId)
 | 
						|
 | 
						|
 | 
						|
 | 
						|
### Example
 | 
						|
```dart
 | 
						|
import 'package:openapi/api.dart';
 | 
						|
// TODO Configure API key authorization: cookie
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure API key authorization: api_key
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKey = 'YOUR_API_KEY';
 | 
						|
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
 | 
						|
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKeyPrefix = 'Bearer';
 | 
						|
// TODO Configure HTTP Bearer authorization: bearer
 | 
						|
// Case 1. Use String Token
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken('YOUR_ACCESS_TOKEN');
 | 
						|
// Case 2. Use Function which generate token.
 | 
						|
// String yourTokenGeneratorFunction() { ... }
 | 
						|
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);
 | 
						|
 | 
						|
final api_instance = ActivityApi();
 | 
						|
final albumId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | 
 | 
						|
final assetId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | 
 | 
						|
 | 
						|
try {
 | 
						|
    final result = api_instance.getActivityStatistics(albumId, assetId);
 | 
						|
    print(result);
 | 
						|
} catch (e) {
 | 
						|
    print('Exception when calling ActivityApi->getActivityStatistics: $e\n');
 | 
						|
}
 | 
						|
```
 | 
						|
 | 
						|
### Parameters
 | 
						|
 | 
						|
Name | Type | Description  | Notes
 | 
						|
------------- | ------------- | ------------- | -------------
 | 
						|
 **albumId** | **String**|  | 
 | 
						|
 **assetId** | **String**|  | [optional] 
 | 
						|
 | 
						|
### Return type
 | 
						|
 | 
						|
[**ActivityStatisticsResponseDto**](ActivityStatisticsResponseDto.md)
 | 
						|
 | 
						|
### Authorization
 | 
						|
 | 
						|
[cookie](../README.md#cookie), [api_key](../README.md#api_key), [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)
 | 
						|
 |