Calling ION APIs from Postman

The first step in integrating to Infor's Multi-tenant CloudSuite via ION APIs is by simulating the call of these using a tool like Postman. This article will quickly run through the process for this. In this we:

1. Obtain the URL to call an ION API
2. Create an authorised transaction that can call the ION API
3. Call the ION API from Postman

Step 1: Calling the API from ION API in Ming.le

Select the suite to call the API from. I'll use M3:

Find the API to use, then click Documentation:

Select the API transaction to use, then click Try it out:

Enter the parameters to use for the API transaction and click Execute:

Save the request URL returned e.g.

https://mingle-ionapi.se2.inforcloudsuite.com/#######_TRN/M3/m3api-rest/execute/EXPORTMI/Select/?SEPC=%7C&HDRS=1&QERY=count(*)%20from%20MITTRA

Step 2: Creating an ION API Authorised application

From ION ION create a new Authorised App / Backend service:

Then Download Credentials:

Set the credentials to be a service account, then specify the user to use.

The json file returned will look like this:

{
	"ti":"######_TRN",
	"cn":"Example_TRN",
	"dt":"12",
	"ci":"######_TRN~********************",
	"cs":"@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@",
	"iu":"https://mingle-ionapi.se2.inforcloudsuite.com",
	"pu":"https://mingle-sso.se2.inforcloudsuite.com:443/######_TRN/as/",
	"oa":"authorization.oauth2",
	"ot":"token.oauth2",
	"or":"revoke_token.oauth2",
	"ev":"^^^^^^^^^^^^",
	"v":"1.0",
	"saak":"######_TRN$$$$$$$$$$$$$$$$$$$",
	"sask":":::::::::::::::::::::::::::::"

}

Step 3: Calling the ION API from Postman

In Postman, paste the request URL from step 1 into the URL field:

On the Authorisation tab, change the type to OAuth 2.0, and click the Get New Access Token button:

Change the Grant Type to Password Credentials.

Enter pu + ot from the json file into the Access Token URL e.g.

https://mingle-sso.se2.inforcloudsuite.com:443/######_TRN/as/token.oauth2

Enter saak from the json file into the Username.

Enter sask from the json file into the Password.

Enter ci from the json file into the Client ID.

Enter cs from the json file into the Client Secret.

Click Request Token. This will return a token. Click Use Token.

This will put the token into the Access Token field. Then click Send to call the ION API:

This returns the data requested.

For more details see the Infor presentation here.

27 Jan 2020 Update

Minor update to this, when talking to single-tenant / on-premises ION APIs there are two changes to the logic above when generating the access token.

1. ot is "connect/token" not "token.oauth2"; and
2. It appears Scope must be entered. I have this set to "Default_Scope"