Quick Start using Postman (Windows environment)
If you have Postman, then you can import our example Postman collection which is any easy way to try out the Hub Service REST methods.
If you don't already have Postman installed, you can download for free from the following location - https://www.postman.com/downloads/
Ensure that you have installed the Hub Service software and then open Postman and choose Import from the top menu bar, then select install from 'Link' and use the following to import the Hub Service Collection:
Now click on the Manage Environment icon and then choose Add. Set the Environment Name to HubServiceComplete and set up the following environment variables using your own Hub Service Activation key instead of the one shown in the screenshot below:
The Hub Service Collection that we've imported will make use of these environment variables etc. The great thing about the collection is that it lists every method that the Hub Service makes available allowing you to try things out quickly and see the results without having to write actual code.
For example, work your way through the following requests in the Postman Collection to get a flavor for how it works, use the Send button to send the Requests to the Hub Service:
- Create Initialised engine - will create a new engine using the activation code specified in your environment variables that you created in Postman.
- Apply Settings String UK Lookup - configures the Hub service to run in lookup mode - look at the Request Body and you will see the configuration XML that is being sent to the Hub Service method.
- Add Block of Data table 1 - this request has been configured to send 6 records to the Hub Service and store them in table 1.
- No More Data table 1 - tells the Hub Service that we have completed loading data into Table 1.
- Lookup JSON - this will perform a JSON lookup request on the Hub Service. If you look at the Body section of the request, you can see the record that is to be searched for (specified in the appropriate JSON format expected) in the loaded table 1 data. Edit the request and set the minimum score to 80, then choose Send. Once you send the request, the Hub Service will respond with any matching records.
- Delete Engine - deletes the engine that we used and releases the memory that the Hub Service consumed.