Die deutsche Fassung finden Sie hier.

You can make requests to the cobby API in your shop from outside cobby using this handy tool and the guide below. If are looking for a full list of events and requests for your own developments, check the List of API-requests and API-events.

1. Download Postman
Visit getpostman.com, download the version of choice for your OS, then install and launch it.

2. Download and import our API-request collectionsWe have put together collections of API-requests, that you can import straight away into postman, these can be found in the link below under releases, just download the one that matches your version of cobby:

API-requests for cobby

Then click on Import in Postman,

choose Import File and select the file you just downloaded.

3. create an Environment for your shop
To save you the hassle of reentering data every time you need to troubleshoot, you can set up an environment for each Magento shop:

click on the gear-symbol in the upper right corner of Postman,

then click on Manage Environments. Afterwards click: 

In the box right under Edit Environment you can enter a descriptive name of your choice for the environment. Underneath that you will want to have the following keys with the correct values for your shop (see below).

Notice that the keys are in camelCase:

shopUrl - your shop URL including cobbys Api-path
apiUser - cobbys user account in your shop. Check the backend under system --> Configuration --> Services / cobby (for m1) or Stores -> Settings: Configurations -> Services: cobby (for m2)
apiPassword - the password of that account
cobbyVersion - your cobby version, replace all dots with underscores
licenseKey - your cobby license key

Once everything is entered, click 

 once more.

4. Our first request: obtain a sessionKey In order to use any other request, you'll always need a valid sessionkey first. To obtain your session key, choose Login (Magento1)  from the collection on the left and hit "Send",

[if you are troubleshooting Magento 2 click instead]

copy the result without quotes, then click on the eye-symbol in the upper right corner and edit Globals,

add the key sessionKey (in camelCase) to globals and paste the sessionkey as value.

Hit "Save" to store your sessionkey. You are now ready to make any other request to your shop. If your session key expires, repeat this step. 

5. Our second request: export an attribute
Obtain a session key, then click on Attribute (info) afterwards click on Body

, then overwrite the text AttributeId with your attribute ID and hit Send.

Did this answer your question?