Skip to content

The Official eZmax and eZsign QT5 C++ SDK for interacting with the REST API.

License

Notifications You must be signed in to change notification settings

eZmaxinc/eZmax-SDK-cpp-qt-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

99 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

C++ Qt API client

eZmax API Definition (Full)

  • API version: 1.2.0
  • Generator version: 7.4.0

This API expose all the functionnalities for the eZmax and eZsign applications.

For more information, please visit https://www.ezmax.ca/en/contact

Automatically generated by the OpenAPI Generator

Requirements

Building the API client library requires:

  1. CMake 3.2+
  2. Qt
  3. C++ Compiler

Getting Started

example.h:

#include <iostream>
#include "../client/GlobalCustomerApi.h"

using namespace test_namespace;

class Example : public QObject {
    Q_OBJECT
    QString create();
    QString create();
public Q_SLOTS:
   void exampleFunction1();
};

example.cpp:

#include "../client/GlobalCustomerApi.h"
#include "example.h"
#include <QTimer>
#include <QEventLoop>

QString Example::create(){
    QString obj;
QString Example::create(){
    QString obj;
 return obj;
}

void Example::exampleFunction1(){
     GlobalCustomerApi apiInstance;
     
      QEventLoop loop;
      connect(&apiInstance, &GlobalCustomerApi::globalCustomerGetEndpointV1Signal, [&]() {
          loop.quit();
      });
      connect(&apiInstance, &GlobalCustomerApi::globalCustomerGetEndpointV1SignalE, [&](QNetworkReply::NetworkError, QString error_str) {
          qDebug() << "Error happened while issuing request : " << error_str;
          loop.quit();
      });

      QString pks_customer_code = create(); // QString | 

      QEventLoop loop;
      connect(&apiInstance, &GlobalCustomerApi::globalCustomerGetEndpointV1Signal, [&]() {
          loop.quit();
      });
      connect(&apiInstance, &GlobalCustomerApi::globalCustomerGetEndpointV1SignalE, [&](QNetworkReply::NetworkError, QString error_str) {
          qDebug() << "Error happened while issuing request : " << error_str;
          loop.quit();
      });

      QString s_infrastructureproduct_code = create(); // QString | The infrastructure product Code  If undefined, \"appcluster01\" is assumed
      apiInstance.globalCustomerGetEndpointV1(pks_customer_codes_infrastructureproduct_code);
      QTimer::singleShot(5000, &loop, &QEventLoop::quit);
      loop.exec();
  }

Documentation for Servers

Parameterized Servers are supported. Define a server in the API for each endpoint with arbitrary numbers of variables:

servers:
- url: http://{server}:{port}/{basePath}
  description: Description of the Server
  variables:
    server:
        enum:
          - 'petstore'
          - 'qa-petstore'
          - 'dev-petstore'
        default: 'petstore'
    port:
      enum:
        - '3000'
        - '1000'
      default: '3000'
    basePath:
      default: v1

To change the default variable, use this function in each Api:

int setDefaultServerValue(int serverIndex,const QString &operation, const QString &variable,const QString &val);

The parameter "serverIndex" will choose a server from the server list for each endpoint. There is always at least one server with index 0. The Parameter "operation" should be the desired endpoint operationid. Variable is the name of the variable you wish to change and the value is the new default Value. The function will return -1 when the variable does not exists, -2 if value is not defined in the variable enum and -3 if the operation is not found.

If your endpoint has multiple server objects in the servers array, you can set the server that will be used with this function:

void setServerIndex(const QString &operation, int serverIndex);

Parameter "operation" should be your operationid. "serverIndex" is the index you want to set as your default server. The function will check if there is a server with your index. Here is an example of multiple servers in the servers array. The first server will have index 0 and the second will have index 1.

servers:
- url: http://{server}:8080/
  description: Description of the Server
  variables:
    server:
        enum:
          - 'petstore'
          - 'qa-petstore'
          - 'dev-petstore'
        default: 'petstore'
- url: https://localhost:8080/v1

Documentation for Authorization

Authentication schemes defined for the API:

Authorization

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

Bearer

  • Type: HTTP Bearer Token authentication

Presigned

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

Author

[email protected]

License

MIT License for more information visit MIT License