Getting started with WorldFirst APIs
This document provides a comprehensive guide to make your first WorldFirst API call with Postman.
-
For the first-time integrating Partners, contact WorldFirst Technical Support to make sure your IP address is on the whitelist.
Step 1. Download a premade script
Contact WorldFirst Technical Support to obtain the sample script and import the file to your Postman Workspace.
-
The signature provided above is a demo signature. For detailed steps to generate a unique signature instead of using a testing signature, refer to the Calculate and generate the signature chapter.
Step 2. Configure the request header
Configure the header parameters after loading the sample Postman script.
Sample values:
HTTP URL:
http://{domain_name}/amsin/api/v1/business/fund/inquiryRate
Method:
POST
Client-Id:
*****
Signature:
algorithm=RSA256,keyVersion=1,signature=KEhXthj4bJ801Hqw8kaLvEKc0Rii8KsNUazw7kZgjxyGSPuOZ48058UVJUkkR21iD9JkHBGRrWiHPae8ZRPuBagh2H3qu7fxY5GxVDWayJUhUYkr9m%2FOW4UQVmXaQ9yn%2Fw2dCtzwAW0htPHYrKMyrTpMk%2BfDDmRflA%2FAMJhQ71yeyhufIA2PCJV8%2FCMOa46303A0WHhH0YPJ9%2FI0UeLVMWlJ1XcBo3JrbRFvcowQwt0lP1XkoPmSLGpBevDE8%2FQ9WnxjPNDfrHnKgV2fp0hpMKVXNM%2BrLHNyMv3MkHg9iTMOD%2FFYDAwSd%2B6%2FEOFo9UbdlKcmodJwjKlQoxZZIzmF8w%*****
request-time:
now()
Content-type:
application/json
-
Step 3. Configure the request body
Click on the Body tab above the value field. Choose the raw option, and insert the following request body into the text box:
{ "inquiryRateConditionList": [ { "sellCurrency": "USD", "buyCurrency": "EUR" }, { "sellCurrency": "USD", "buyCurrency": "GBP" } ] }
-
Step 4. Send the API request
Click on the Send button to initiate your first WorldFirst API call. In the Response section, you would be able to see the response indicating the API call is successful.