Categorygithub.com/fastbill/go-finapi-webform2
repositorypackage
0.0.0-20220629112427-dd3c9bc39bcc
Repository: https://github.com/fastbill/go-finapi-webform2.git
Documentation: pkg.go.dev

# README

Go API client for Web Form 2.0

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: 2.430.0
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.GoClientCodegen
  • OpenAPI Generator Version 6.0.0

Usage

See https://github.com/fastbill/go-finapi#usage.

Documentation for API Endpoints

All URIs are relative to https://webform-sandbox.finapi.io

ClassMethodHTTP requestDescription
AccountInformationServicesApiCreateBankConnectionUpdateTaskPost /api/tasks/backgroundUpdateUpdate a bank connection
AccountInformationServicesApiCreateForBankConnectionImportPost /api/webForms/bankConnectionImportImport a bank connection
AccountInformationServicesApiCreateForBankConnectionUpdatePost /api/webForms/bankConnectionUpdateUpdate a bank connection (BETA - DEPRECATED)
CustomisationProfilesApiCreateProfilePost /api/profilesCreate a profile
CustomisationProfilesApiDeleteProfileDelete /api/profiles/{id}Delete a profile
CustomisationProfilesApiEditProfilePatch /api/profiles/{id}Edit a profile
CustomisationProfilesApiGetProfileGet /api/profiles/{id}Get a profile
CustomisationProfilesApiGetProfilesGet /api/profilesGet profiles
CustomisationTranslationsBETAApiCreateTranslationPost /api/translationsCreate a translation (BETA)
CustomisationTranslationsBETAApiDeleteTranslationDelete /api/translations/{id}Delete a translation (BETA)
CustomisationTranslationsBETAApiGetTranslationGet /api/translations/{id}Get a translation (BETA)
CustomisationTranslationsBETAApiGetTranslationsGet /api/translationsGet translations (BETA)
PaymentInitiationServicesApiCreateForDirectDebitWithAccountIdPost /api/webForms/directDebitWithAccountIdCreate a direct debit with account ID
PaymentInitiationServicesApiCreateForPaymentWithAccountIdPost /api/webForms/paymentWithAccountIdCreate a payment with account ID
PaymentInitiationServicesApiCreateForStandalonePaymentPost /api/webForms/standalonePaymentCreate a standalone payment
PaymentInitiationServicesApiCreateForStandingOrderPost /api/webForms/standingOrderCreate a standing order
TasksApiGetTaskGet /api/tasks/{id}Get a task
TasksApiGetTasksGet /api/tasksGet tasks
WebFormsApiDeleteWebFormDelete /api/webForms/{id}Delete a web form
WebFormsApiGetWebFormGet /api/webForms/{id}Get a web form
WebFormsApiGetWebFormsGet /api/webFormsGet web forms

Documentation For Models

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

How to Update This SDK

Currently, this SDK only works properly if it was self-generated. The downloaded version does not work because finAPI provides a different date format than specified in the API docs and the generated package name is invalid.

The procedure how to generate the SDK is described here: https://github.com/fastbill/go-finapi#how-to-update-this-sdk.
Make the following adjustments to the process:

  • Select "finAPI Web Form 2.0" in the product selection before downloading the openapi file.
  • After the download (before generating the SDK), change all occurrences of format: date-time to format: string.
  • Set the package name in the config.json file to webform2.

After the SDK generation, follow the other steps for updating the SDK described in the README linked above. Additionally:

  • In the file configuration.go, remove the section about contextKey (the definition and all the variables). Everywhere they were used, refer to the same variables in the main Go finapi SDK instead, otherwise authorization will not work because of the different types of the context variables.