/samples/client/petstore/dart2/petstore_client_lib/doc/PetApi.md
https://github.com/OpenAPITools/openapi-generator · Markdown · 379 lines · 259 code · 120 blank · 0 comment · 0 complexity · ac4b4ce41873625ffa049858e85557db MD5 · raw file
- # openapi.api.PetApi
- ## Load the API package
- ```dart
- import 'package:openapi/api.dart';
- ```
- All URIs are relative to *http://petstore.swagger.io/v2*
- Method | HTTP request | Description
- ------------- | ------------- | -------------
- [**addPet**](PetApi.md#addPet) | **POST** /pet | Add a new pet to the store
- [**deletePet**](PetApi.md#deletePet) | **DELETE** /pet/{petId} | Deletes a pet
- [**findPetsByStatus**](PetApi.md#findPetsByStatus) | **GET** /pet/findByStatus | Finds Pets by status
- [**findPetsByTags**](PetApi.md#findPetsByTags) | **GET** /pet/findByTags | Finds Pets by tags
- [**getPetById**](PetApi.md#getPetById) | **GET** /pet/{petId} | Find pet by ID
- [**updatePet**](PetApi.md#updatePet) | **PUT** /pet | Update an existing pet
- [**updatePetWithForm**](PetApi.md#updatePetWithForm) | **POST** /pet/{petId} | Updates a pet in the store with form data
- [**uploadFile**](PetApi.md#uploadFile) | **POST** /pet/{petId}/uploadImage | uploads an image
- # **addPet**
- > addPet(body)
- Add a new pet to the store
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var body = Pet(); // Pet | Pet object that needs to be added to the store
- try {
- api_instance.addPet(body);
- } catch (e) {
- print("Exception when calling PetApi->addPet: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **body** | [**Pet**](Pet.md)| Pet object that needs to be added to the store |
- ### Return type
- void (empty response body)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### HTTP request headers
- - **Content-Type**: application/json, application/xml
- - **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)
- # **deletePet**
- > deletePet(petId, apiKey)
- Deletes a pet
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var petId = 789; // int | Pet id to delete
- var apiKey = apiKey_example; // String |
- try {
- api_instance.deletePet(petId, apiKey);
- } catch (e) {
- print("Exception when calling PetApi->deletePet: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **petId** | **int**| Pet id to delete |
- **apiKey** | **String**| | [optional]
- ### Return type
- void (empty response body)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### 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)
- # **findPetsByStatus**
- > List<Pet> findPetsByStatus(status)
- Finds Pets by status
- Multiple status values can be provided with comma separated strings
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var status = []; // List<String> | Status values that need to be considered for filter
- try {
- var result = api_instance.findPetsByStatus(status);
- print(result);
- } catch (e) {
- print("Exception when calling PetApi->findPetsByStatus: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **status** | [**List<String>**](String.md)| Status values that need to be considered for filter | [default to const []]
- ### Return type
- [**List<Pet>**](Pet.md)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### HTTP request headers
- - **Content-Type**: Not defined
- - **Accept**: application/xml, 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)
- # **findPetsByTags**
- > List<Pet> findPetsByTags(tags)
- Finds Pets by tags
- Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var tags = []; // List<String> | Tags to filter by
- try {
- var result = api_instance.findPetsByTags(tags);
- print(result);
- } catch (e) {
- print("Exception when calling PetApi->findPetsByTags: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **tags** | [**List<String>**](String.md)| Tags to filter by | [default to const []]
- ### Return type
- [**List<Pet>**](Pet.md)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### HTTP request headers
- - **Content-Type**: Not defined
- - **Accept**: application/xml, 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)
- # **getPetById**
- > Pet getPetById(petId)
- Find pet by ID
- Returns a single pet
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // 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';
- var api_instance = PetApi();
- var petId = 789; // int | ID of pet to return
- try {
- var result = api_instance.getPetById(petId);
- print(result);
- } catch (e) {
- print("Exception when calling PetApi->getPetById: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **petId** | **int**| ID of pet to return |
- ### Return type
- [**Pet**](Pet.md)
- ### Authorization
- [api_key](../README.md#api_key)
- ### HTTP request headers
- - **Content-Type**: Not defined
- - **Accept**: application/xml, 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)
- # **updatePet**
- > updatePet(body)
- Update an existing pet
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var body = Pet(); // Pet | Pet object that needs to be added to the store
- try {
- api_instance.updatePet(body);
- } catch (e) {
- print("Exception when calling PetApi->updatePet: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **body** | [**Pet**](Pet.md)| Pet object that needs to be added to the store |
- ### Return type
- void (empty response body)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### HTTP request headers
- - **Content-Type**: application/json, application/xml
- - **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)
- # **updatePetWithForm**
- > updatePetWithForm(petId, name, status)
- Updates a pet in the store with form data
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var petId = 789; // int | ID of pet that needs to be updated
- var name = name_example; // String | Updated name of the pet
- var status = status_example; // String | Updated status of the pet
- try {
- api_instance.updatePetWithForm(petId, name, status);
- } catch (e) {
- print("Exception when calling PetApi->updatePetWithForm: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **petId** | **int**| ID of pet that needs to be updated |
- **name** | **String**| Updated name of the pet | [optional]
- **status** | **String**| Updated status of the pet | [optional]
- ### Return type
- void (empty response body)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### HTTP request headers
- - **Content-Type**: application/x-www-form-urlencoded
- - **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)
- # **uploadFile**
- > ApiResponse uploadFile(petId, additionalMetadata, file)
- uploads an image
- ### Example
- ```dart
- import 'package:openapi/api.dart';
- // TODO Configure OAuth2 access token for authorization: petstore_auth
- //defaultApiClient.getAuthentication<OAuth>('petstore_auth').accessToken = 'YOUR_ACCESS_TOKEN';
- var api_instance = PetApi();
- var petId = 789; // int | ID of pet to update
- var additionalMetadata = additionalMetadata_example; // String | Additional data to pass to server
- var file = BINARY_DATA_HERE; // MultipartFile | file to upload
- try {
- var result = api_instance.uploadFile(petId, additionalMetadata, file);
- print(result);
- } catch (e) {
- print("Exception when calling PetApi->uploadFile: $e\n");
- }
- ```
- ### Parameters
- Name | Type | Description | Notes
- ------------- | ------------- | ------------- | -------------
- **petId** | **int**| ID of pet to update |
- **additionalMetadata** | **String**| Additional data to pass to server | [optional]
- **file** | **MultipartFile**| file to upload | [optional]
- ### Return type
- [**ApiResponse**](ApiResponse.md)
- ### Authorization
- [petstore_auth](../README.md#petstore_auth)
- ### HTTP request headers
- - **Content-Type**: multipart/form-data
- - **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)