diff --git a/Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/README.md b/Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/README.md new file mode 100644 index 0000000000..419e15c0e7 --- /dev/null +++ b/Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/README.md @@ -0,0 +1,19 @@ +# Currency Conversion- Using CurrencyFreaks API +## Overview +This API allows to convert an amount from USD to any selected currency in real-time using live exchange rates fetched from the CurrencyFreaks API. + +## Configuration Steps +### Get Your CurrencyFreaks API Key +1. Go to https://currencyfreaks.com +2. Sign up for a free account. +3. Navigate to Dasboard ->API Keys. +4. Copy your API key - you'll need it in ServiceNow. + +### Create a REST Message in ServiceNow +- Name: CurrencyFreaks API +- Endpoint: https://api.currencyfreaks.com/v2.0/rates/latest?apikey=${apikey}&symbols=${symbols} +- HTTP Method: GET + +### Example Response +```json +{"date":"2025-10-30 00:00:00+00","base":"USD","rates":{"EUR":"0.861846","SAR":"3.7502","KWD":"0.30678","INR":"88.4075"}} diff --git a/Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/script.js b/Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/script.js new file mode 100644 index 0000000000..0a4895f911 --- /dev/null +++ b/Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/script.js @@ -0,0 +1,22 @@ +var symbols ="INR,EUR,KWD,SAR"; //Enter symbol name like SAR,AED +var apiKey =""; // Paste your CurrencyFreaks APIKEY here +getExchangeReate(apiKey, symbols); + +function getExchangeReate(apiKey,symbols){ + try { + + var r = new sn_ws.RESTMessageV2('ExchangeRate API', 'Default GET'); + r.setStringParameterNoEscape('symbols', symbols); + r.setStringParameterNoEscape('apikey', apiKey); + + + var response = r.execute(); + var responseBody = response.getBody(); + var httpStatus = response.getStatusCode(); + gs.print("Status: " +httpStatus); + gs.print("Result:" +responseBody); //It will show conversion from USD the selected currency +} +catch(ex) { + var message = ex.message; +} +}