openapi-generator-original/samples/client/petstore/swift6/apiNonStaticMethod/README.md

Swift6 API client for PetstoreClient

This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: " \

Overview

This API client was generated by the OpenAPI Generator project. By using the openapi-spec from a remote server, you can easily generate an API client.

• API version: 1.0.0
• Package version:
• Generator version: 7.10.0-SNAPSHOT
• Build package: org.openapitools.codegen.languages.Swift6ClientCodegen

Installation

Carthage

Run carthage update

CocoaPods

Run pod install

Documentation for API Endpoints

All URIs are relative to http://petstore.swagger.io:80/v2

Class	Method	HTTP request	Description
AnotherFakeAPI	call123testSpecialTags	PATCH /another-fake/dummy	To test special tags
FakeAPI	fakeOuterBooleanSerialize	POST /fake/outer/boolean
FakeAPI	fakeOuterCompositeSerialize	POST /fake/outer/composite
FakeAPI	fakeOuterNumberSerialize	POST /fake/outer/number
FakeAPI	fakeOuterStringSerialize	POST /fake/outer/string
FakeAPI	testBodyWithFileSchema	PUT /fake/body-with-file-schema
FakeAPI	testBodyWithQueryParams	PUT /fake/body-with-query-params
FakeAPI	testClientModel	PATCH /fake	To test "client" model
FakeAPI	testEndpointParameters	POST /fake	Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트
FakeAPI	testEnumParameters	GET /fake	To test enum parameters
FakeAPI	testGroupParameters	DELETE /fake	Fake endpoint to test group parameters (optional)
FakeAPI	testInlineAdditionalProperties	POST /fake/inline-additionalProperties	test inline additionalProperties
FakeAPI	testJsonFormData	GET /fake/jsonFormData	test json serialization of form data
FakeClassnameTags123API	testClassname	PATCH /fake_classname_test	To test class name in snake case
PetAPI	addPet	POST /pet	Add a new pet to the store
PetAPI	deletePet	DELETE /pet/{petId}	Deletes a pet
PetAPI	findPetsByStatus	GET /pet/findByStatus	Finds Pets by status
PetAPI	findPetsByTags	GET /pet/findByTags	Finds Pets by tags
PetAPI	getPetById	GET /pet/{petId}	Find pet by ID
PetAPI	updatePet	PUT /pet	Update an existing pet
PetAPI	updatePetWithForm	POST /pet/{petId}	Updates a pet in the store with form data
PetAPI	uploadFile	POST /pet/{petId}/uploadImage	uploads an image
PetAPI	uploadFileWithRequiredFile	POST /fake/{petId}/uploadImageWithRequiredFile	uploads an image (required)
StoreAPI	deleteOrder	DELETE /store/order/{order_id}	Delete purchase order by ID
StoreAPI	getInventory	GET /store/inventory	Returns pet inventories by status
StoreAPI	getOrderById	GET /store/order/{order_id}	Find purchase order by ID
StoreAPI	placeOrder	POST /store/order	Place an order for a pet
UserAPI	createUser	POST /user	Create user
UserAPI	createUsersWithArrayInput	POST /user/createWithArray	Creates list of users with given input array
UserAPI	createUsersWithListInput	POST /user/createWithList	Creates list of users with given input array
UserAPI	deleteUser	DELETE /user/{username}	Delete user
UserAPI	getUserByName	GET /user/{username}	Get user by user name
UserAPI	loginUser	GET /user/login	Logs user into the system
UserAPI	logoutUser	GET /user/logout	Logs out current logged in user session
UserAPI	updateUser	PUT /user/{username}	Updated user

Documentation For Models

• AdditionalPropertiesClass
• Animal
• ApiResponse
• ArrayOfArrayOfNumberOnly
• ArrayOfNumberOnly
• ArrayTest
• Capitalization
• Cat
• Category
• ClassModel
• Client
• Dog
• EnumArrays
• EnumClass
• EnumTest
• File
• FileSchemaTestClass
• FormatTest
• HasOnlyReadOnly
• List
• MapTest
• MixedPropertiesAndAdditionalPropertiesClass
• Model200Response
• Name
• NumberOnly
• Order
• OuterComposite
• OuterEnum
• Pet
• ReadOnlyFirst
• Return
• SpecialModelName
• Tag
• TypeHolderDefault
• TypeHolderExample
• User

Documentation For Authorization

Authentication schemes defined for the API:

petstore_auth

• Type: OAuth
• Flow: implicit
• Authorization URL: http://petstore.swagger.io/api/oauth/dialog
• Scopes:
• write:pets: modify pets in your account
• read:pets: read your pets

api_key

• Type: API key
• API key parameter name: api_key
• Location: HTTP header

api_key_query

• Type: API key
• API key parameter name: api_key_query
• Location: URL query string

http_basic_test

• Type: HTTP basic authentication

How do I implement bearer token authentication with Alamofire on the Swift 6 API client?

First implement the Alamofire RequestInterceptor protocol.

class BearerTokenHandler: RequestInterceptor, @unchecked Sendable {
    private var bearerToken: String? = nil
    
    func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest, Error>) -> Void) {
        if let bearerToken = bearerToken {
            var urlRequest = urlRequest
            urlRequest.setValue("Bearer \(bearerToken)", forHTTPHeaderField: "Authorization")
            
            completion(.success(urlRequest))
            return
        }
        
        completion(.success(urlRequest))
    }
    
    func retry(_ request: Request, for session: Session, dueTo error: Error, completion: @escaping (RetryResult) -> Void) {
        if let response = request.task?.response as? HTTPURLResponse, response.statusCode == 401 {
            startRefreshingToken { isTokenRefreshed in
                completion(.retry)
            }
        } else {
            completion(.doNotRetryWithError(error))
        }
    }
    
    private func startRefreshingToken(completionHandler: @escaping (Bool) -> Void) {
        // Get a bearer token
        let dummyBearerToken = "..."
        
        bearerToken = dummyBearerToken
        OpenAPIClient.shared.customHeaders["Authorization"] = "Bearer \(dummyBearerToken)"
        
        completionHandler(true)
    }
}

Then you assign the BearerTokenHandler to the property OpenAPIClient.shared.interceptor.

OpenAPIClient.shared.interceptor = BearerTokenHandler()

Here is a working sample that put's together all of this. AppDelegate.swift BearerTokenHandler.swift

Author