ACCESSING THE WEB API

Webopedia definition of "API"

API - application program interface

API, an abbreviation of application program interface, is a set of routines, protocols, and tools for building software applications. The API specifies how software components should interact and APIs are used when programming graphical user interface (GUI) components.  A good API makes it easier to develop a program by providing all the building blocks. A programmer then puts the blocks together.

Types of APIs

Please click this link to know more: http://www.webopedia.com/TERM/A/API.html

Please click to read first the blog on "3RD PARTY INTERFACE IS POSSIBLE IN IKONOMIKAL".

Accessing the Ikonomikal Web API

Content:

1. Requirements
2. Enable WEB API
3. Granting Access To Roles
4. Request And Response Method 
• JSON Format Example
• Class Example
• JSON Serialized/De-serialized to Class
5. Basic Example (“Adding A New Department”)
• Log-In
• Requesting for a "NEW" token
• Executing the "NEW" procedure
• Complete the Program
6. 3rd Party Interface
• Why Mapped Fields and Batch Upload is Recommended?
• Why API in Real-Tim Communication is not Recommended?

1. Requirements

The following are the major requirements to access the API:

Functional:

1. Registered Email ID
2. Active company subscription
3. Currently assigned to a company by invitation
4. Enabled API Access (to bypass the captcha requirement)

Development Language:

1. Must support Classes
2. Must support JSON Format
3. Must be able to Serialize and De-serialize JSON
4. Must support HTTP or Web Request

2. Enable WEB API

Enabling WEB API from Ikonomikal User Home Page

3. Granting Access To Roles

Example: Granting “NEW” access to Department Profile

4. Request And Response

Ikonomikal API’s are accessed by issuing a POST request And receiving a response in JSON Format.

Note: This cannot be done on the browser unless the Cross Origin Resource Sharing (CORS) policy is disabled.

4.1 JSON Format Example

4.2 Class Example

4.3 JSON Serialized/De-Serialized To A Class

5. Basic Example

“Adding A New Department Profile”

5.1 Log-IN

5.2 Requesting for a “NEW” token

5.3 Execute the “NEW“ procedure

5.4 Complete Program

6. 3rd Party Interface

• Why Mapped Fields and Batch Upload is Recommended
• Why API in Real-Time Communication is not Recommended.

6.1 Mapped Fields And Batch Upload

THIS IS AN IKONOMIKAL PROGRAM

Fully Integrated With Other Ikonomikal Programs

THIS COULD BE YOUR PROGRAM

FEATURES:

• Your programs’ performance will be based on how much hardware you install.
• You can add any field or data you want in future revisions without asking us to modify our system.
• Your program will only communicate with Ikonomikal during a scheduled batch upload and use the ikonomikal MAP field in place of the Department Code. 
• The batch upload data is scheduled and can be monitored and then corrected before it goes to ikonomikal.
• Operations users can continue working even if ikonomikal is under maintenance or if you suddenly lost connection to ikonomikal. Only the batch upload will not run.
• Use this technique if you want to minimize inter system maintenance down-times. 

Think of a Point Of Sale System that connects to an ERP or any Accounting System. 

With mapped fields and batch upload, customers and cashiers are able to complete transactions even when the ERP or Accounting System is on maintenance.

Mapped Fields and Batch Upload is recommended

6.2 API in Real-Time communication

THIS IS AN IKONOMIKAL PROGRAM

Fully Integrated With Other Ikonomikal Programs

THIS COULD BE YOUR PROGRAM

FEATURES:

• You will have to map your program users to ikonomikal users so they could be assigned with the correct Roles (this is for each User you create in your system). 
• You need constant API Access and needs uninterrupted availability of ikonomikal.
• Which ever system is slowest, is your overall systems’ performance.
• The reverse of the features mentioned in the “MAPPED FIELDS AND BATCH UPLOAD”.

API in Real-Time communication is not recommended

THIS IS ONE OF THE REASONS WHY 

YOU HAVE TO COMPLETE YOUR SYSTEM SO IT CAN RUN INDEPENDENTLY

Ikonomikal Sample API of a Department Profile.

Please do the following:

1. Click this link : https://github.com/iamshotgun/IkonomikalAPISamples

2. Click Clone or download

3. Download Zip

Requirements:

Visual Studio 2013

VB.NET

Microsoft .NET 4.6

You may also be interested to know (please click to browse):

1. What are the Security Features of Ikonomikal?
2. How Robust is Ikonomikal?
3. What is Ikonomikal SSL Security Level? 
4. Is 3rd Party Interface Possible in Ikonomikal?
5. Ikonomikal Programming Language and Environment Diagram
6. Company website of Ikonomikal
7. Ikonomikal software site
8. What is Ikonomikal?

Click to Email: Teodoro Rolluqui

Accessing the

Ikonomikal Web API

IS 3RD PARTY INTERFACE POSSIBLE IN IKONOMIKAL?

YES, 3RD PARTY INTERFACE IS POSSIBLE IN IKONOMIKAL

Behind the possibility of 3rd Party Interface in Ikonomikal are the architecture and ways to make it work.

To start with are relevant topics such as

1. 3 Tier Architecture
2. Web API Layer

1. 3 Tier Architecture

The Ikonomikal program is divided into 3 major Layers:

•      1.1. Presentation Layer – this is where users are able to interact with (ex. Websites).

•      1.2. Business Logic Layer – this is where the program processes the users request (ex. Saving, Deleting, Posting, etc.)

•      1.3. Data Access Layer – this is where the program manipulates the database as requested by the Business Logic Layer.

1.1 Presentation Layer

1.2 Business Logic Layer

1.3 Data Access Layer

This is great news because not all programs are written this way

Ikonomikal is a 3 Tiered Architecture

Some are developed as one host combining all the 3 layers without any end point to integrate with. 

Before we answer the question, let us talk about another layer that makes this all possible…

2. Web API Layer

These are end points or interfaces where you can contact or interact with the Business Logic Layer.

For example, when you call from a telephone with the correct number and the other end rings.

Webopedia definition of "API"

API - application program interface

API, an abbreviation of application program interface, is a set of routines, protocols, and tools for building software applications. The API specifies how software components should interact and APIs are used when programming graphical user interface (GUI) components.  A good API makes it easier to develop a program by providing all the building blocks. A programmer then puts the blocks together.

Types of APIs

Please click this link to know more: http://www.webopedia.com/TERM/A/API.html

Question: 

Is 3rd Party interface possible In Ikonomikal?

The answer is a big

YES

What are the main requirements?

• Your program must support the JSON Format
• You must have a valid Email ID and Password
• You must be invited to a Company

</> 

Quick example on how to connect to API:
(Example: Create a new GL Account)

    1.  Get a save token:
         bcss_wbcl_wa_sc/api/O1_getSCPrgPrcCheckTkn

   2.  Execute the save command:
bcss_wbcl_wa_gl/api/gl_02_gl00001_sav

Our team uses the same set of APIs, which means that you can basically rewrite the entire Presentation Layer for us.

You may be interested to know (please click to browse):

1. What are the Security Features of Ikonomikal?
2. How Robust is Ikonomikal?
3. What is Ikonomikal SSL Security Level?
4. Company website of Ikonomikal
5. Ikonomikal software site
6. What is Ikonomikal?

Please click to send inquiry by email to: Teodoro Rolluqui