mirror of
				https://github.com/immich-app/immich.git
				synced 2025-10-31 10:37:11 -04: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)
 | |
| 
 |