https://github.com/bunq/postman

Postman collection and environments
https://github.com/bunq/postman

banking-api bunq-api postman signing

Last synced: 14 days ago
JSON representation

Postman collection and environments

• Host: GitHub
• URL: https://github.com/bunq/postman
• Owner: bunq
• Created: 2019-03-22T19:47:03.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-02-22T08:33:01.000Z (over 3 years ago)
• Last Synced: 2023-02-27T00:25:57.305Z (over 1 year ago)
• Topics: banking-api, bunq-api, postman, signing
• Size: 41.2 MB
• Stars: 41
• Watchers: 5
• Forks: 17
• Open Issues: 14
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
### What is it?

It's a project that allows you to access bunq's public API using [Postman](https://www.getpostman.com).

### How does one use it?

1. [Get Postman](https://www.getpostman.com/apps)

2. Run it. Don't bother signing in if you don't want to, there's a small link on the bottom to skip. This project does

   not use any of Postman's cloud features.

3. Click `Import` button in top left and drag all the files from the project there

4. In top right corner select your environment (sandbox or production).

5. If you selected sandbox, run `Create a sandbox user` request. It will automatically save your API key to the 

   environment.

6. If you selected production, edit the environment using the "eye" icon. Set "current value" of `api_key` to your API 

   key.

7. Run `Create an installation`, `Add the device`, `Add a session` in that order. They will create everything needed for

   using public API, including RSA keys, session and installation tokens. For you reference all those values will be set

   in the environment.

8. Run `GET - List monetary accounts` to check that everything is working properly. If it does, you can modify that request to

   do whatever you wanted to do and "Save as" for your future use.

### How does it work?

Postman has two javascript features: "Pre-request Script" and "Tests" that can get and set environment variables. Every

pre-request script includes a minimized RSA javascript library ([jsrsasign](https://github.com/kjur/jsrsasign)) and

some code to make signing work. Also, "Tests" save all the interesting values from responses such as tokens so that they

can be used in subsequent requests. Voila!