Getting started with WorldFirst APIs

This document provides a comprehensive guide for making your first WorldFirst API call using Postman.

 

  • For first-time integrating partners, contact WorldFirst Technical Support to ensure your IP address is whitelisted.

    Step 1. Download a sample script

    Contact WorldFirst Technical Support to obtain the sample script, and then import the file into your Postman workspace.

  • The provided signature is a demo signature. For detailed steps to generate a unique signature, refer to the Calculate and generate the signature chapter.

    Step 2. Configure the request header

    After loading the sample Postman script, configure the header parameters using the following 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. Select 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 Send to initiate your first WorldFirst API call. You can see the results in the response section, indicating whether the API call was successful.