Skip to content

eduarddedu/Kontomatik-help-kit

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Kontomatik help kit

This kit is designed to get you up and running with Kontomatik API in less than 1 minute.

The kit contains shell scripts which make it easier for the programmer to invoke API commands, by passing the required Http parameters to the curl utility.

Requirements

  • A valid client id and apiKey. If you don't have them, ask for Test API access here.
  • A text editor, such as Vim.
  • A Unix computer.

You should also read the Kontomatik API tutorial to understand what is going on here.

Usage

Let's say we want to call the default-import command:

  • open a Terminal window and cd to the help-kit folder

  • edit index.html and set the client parameter to the value of your client id

  • write your apiKey to a file named "apiKey"

           echo -n "78***********************************26" > apiKey
    
  • next, load index.html in your browser and login to a bank, using mock credentials "test" -> "Test123". If the login is successful, your browser will display session values, such as these:

           4328763 1195dd958bbeb3c207b36db5ab2be6f33576028c861c518fd6b615565ae63401
    
  • copy the values, switch back to the Terminal and execute default-import.sh, passing sessionId and sessionIdSignature to the script

           sh default-import.sh 4328763 1195dd958bbeb3c207b36db5ab2be6f33576028c861c518fd6b615565ae63401
    

You should now receive a 202 response from the service, in XML format. Note the command "id" attribute:

<?xml version="1.0" encoding="utf-8"?>
<reply status="202 Accepted">
    <command id="4328291" state="in_progress" name="DefaultImportCommand">
        <progress><value>0</value></progress>
    </command>
</reply>

Finally, execute poll.sh, passing the sessionId, sessionIdSignature and commandId parameters:

    sh poll.sh 4328763 1195dd958bbeb3c207b36db5ab2be6f33576028c861c518fd6b615565ae63401 4328291

You should now receive the final response of the default-import command.

About

Shell scripts to call Kontomatik API

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published