Categorygithub.com/lindgrenj6/sources-api-client-go
repositorypackage
0.0.0-20210222222434-c3f89002e26e
Repository: https://github.com/lindgrenj6/sources-api-client-go.git
Documentation: pkg.go.dev

# README

Go API client for sourcesapi

Sources

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: 3.1.0
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.GoClientCodegen

Installation

Install the following dependencies:

go get github.com/stretchr/testify/assert
go get golang.org/x/oauth2
go get golang.org/x/net/context

Put the package under your project folder and add the following in import:

import sw "./sourcesapi"

To use a proxy, set the environment variable HTTP_PROXY:

os.Setenv("HTTP_PROXY", "http://proxy_name:proxy_port")

Configuration of Server URL

Default configuration comes with Servers field that contains server objects as defined in the OpenAPI specification.

Select Server Configuration

For using other server than the one defined on index 0 set context value sw.ContextServerIndex of type int.

ctx := context.WithValue(context.Background(), sw.ContextServerIndex, 1)

Templated Server URL

Templated server URL is formatted using default variables from configuration or from context value sw.ContextServerVariables of type map[string]string.

ctx := context.WithValue(context.Background(), sw.ContextServerVariables, map[string]string{
	"basePath": "v2",
})

Note, enum values are always validated and all unused variables are silently ignored.

URLs Configuration per Operation

Each operation can use different server URL defined using OperationServers map in the Configuration. An operation is uniquely identifield by "{classname}Service.{nickname}" string. Similar rules for overriding default operation server index and variables applies by using sw.ContextOperationServerIndices and sw.ContextOperationServerVariables context maps.

ctx := context.WithValue(context.Background(), sw.ContextOperationServerIndices, map[string]int{
	"{classname}Service.{nickname}": 2,
})
ctx = context.WithValue(context.Background(), sw.ContextOperationServerVariables, map[string]map[string]string{
	"{classname}Service.{nickname}": {
		"port": "8443",
	},
})

Documentation for API Endpoints

All URIs are relative to https://cloud.redhat.com//api/sources/v3.1

ClassMethodHTTP requestDescription
DefaultApiBulkCreatePost /bulk_createBulk-create a Source and specified sub-resources
DefaultApiCheckAvailabilitySourcePost /sources/{id}/check_availabilityChecks Availability of a Source
DefaultApiCreateApplicationPost /applicationsCreate a new Application
DefaultApiCreateApplicationAuthenticationPost /application_authenticationsCreate a new ApplicationAuthentication
DefaultApiCreateAuthenticationPost /authenticationsCreate a new Authentication
DefaultApiCreateEndpointPost /endpointsCreate a new Endpoint
DefaultApiCreateSourcePost /sourcesCreate a new Source
DefaultApiDeleteApplicationDelete /applications/{id}Delete an existing Application
DefaultApiDeleteApplicationAuthenticationDelete /application_authentications/{id}Delete an existing ApplicationAuthentication
DefaultApiDeleteAuthenticationDelete /authentications/{id}Delete an existing Authentication
DefaultApiDeleteEndpointDelete /endpoints/{id}Delete an existing Endpoint
DefaultApiDeleteSourceDelete /sources/{id}Delete an existing Source
DefaultApiGetDocumentationGet /openapi.jsonReturn this API document in JSON format
DefaultApiListAllAppMetaDataGet /app_meta_dataList AppMetaData
DefaultApiListAllApplicationAuthenticationsGet /application_authenticationsList ApplicationAuthentications
DefaultApiListApplicationAuthenticationsGet /applications/{id}/authenticationsList Authentications for Application
DefaultApiListApplicationTypeAppMetaDataGet /application_types/{id}/app_meta_dataList AppMetaData for ApplicationType
DefaultApiListApplicationTypeSourcesGet /application_types/{id}/sourcesList Sources for ApplicationType
DefaultApiListApplicationTypesGet /application_typesList ApplicationTypes
DefaultApiListApplicationsGet /applicationsList Applications
DefaultApiListAuthenticationsGet /authenticationsList Authentications
DefaultApiListEndpointAuthenticationsGet /endpoints/{id}/authenticationsList Authentications for Endpoint
DefaultApiListEndpointsGet /endpointsList Endpoints
DefaultApiListSourceApplicationTypesGet /sources/{id}/application_typesList ApplicationTypes for Source
DefaultApiListSourceApplicationsGet /sources/{id}/applicationsList Applications for Source
DefaultApiListSourceAuthenticationsGet /sources/{id}/authenticationsList Authentications for Source
DefaultApiListSourceEndpointsGet /sources/{id}/endpointsList Endpoints for Source
DefaultApiListSourceTypeSourcesGet /source_types/{id}/sourcesList Sources for SourceType
DefaultApiListSourceTypesGet /source_typesList SourceTypes
DefaultApiListSourcesGet /sourcesList Sources
DefaultApiPostGraphQLPost /graphqlPerform a GraphQL Query
DefaultApiShowAppMetaDataGet /app_meta_data/{id}Show an existing AppMetaData
DefaultApiShowApplicationGet /applications/{id}Show an existing Application
DefaultApiShowApplicationAuthenticationGet /application_authentications/{id}Show an existing ApplicationAuthentication
DefaultApiShowApplicationTypeGet /application_types/{id}Show an existing ApplicationType
DefaultApiShowAuthenticationGet /authentications/{id}Show an existing Authentication
DefaultApiShowEndpointGet /endpoints/{id}Show an existing Endpoint
DefaultApiShowSourceGet /sources/{id}Show an existing Source
DefaultApiShowSourceTypeGet /source_types/{id}Show an existing SourceType
DefaultApiUpdateApplicationPatch /applications/{id}Update an existing Application
DefaultApiUpdateApplicationAuthenticationPatch /application_authentications/{id}Update an existing ApplicationAuthentication
DefaultApiUpdateAuthenticationPatch /authentications/{id}Update an existing Authentication
DefaultApiUpdateEndpointPatch /endpoints/{id}Update an existing Endpoint
DefaultApiUpdateSourcePatch /sources/{id}Update an existing Source

Documentation For Models

Documentation For Authorization

UserSecurity

  • Type: HTTP basic authentication

Example

auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
    UserName: "username",
    Password: "password",
})
r, err := client.Service.Operation(auth, args)

Documentation for Utility Methods

Due to the fact that model structure members are all pointers, this package contains a number of utility functions to easily obtain pointers to values of basic types. Each of these functions takes a value of the given basic type and returns a pointer to it:

  • PtrBool
  • PtrInt
  • PtrInt32
  • PtrInt64
  • PtrFloat
  • PtrFloat32
  • PtrFloat64
  • PtrString
  • PtrTime

Author

[email protected]