Skip to content

eduarddedu/Kontomatik-help-kit

Repository files navigation

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