PaySwitch - 薪資換算器

說明

問題陳述

一家名為Insure Everyone的公司以多種外幣支付員工薪資。但基於法規要求，薪資必須換算成當地貨幣。這家公司的員工遍布世界各地。 Insure Everyone 的人資部門正在尋找一位優秀的開發者，協助打造一支程式，把每位員工的薪資換算成他們對應的當地貨幣。Insure Everyone 依賴外部 API 提供的匯率。

有了這個外部匯率 API，你需要寫一個函式，接收source currency、salary（以來源貨幣計價）以及員工的local currency，並回傳換算成當地貨幣的薪資。

貨幣匯率 API

外部貨幣匯率 API 的回應如下：

注意：為了讓題目簡短，rates已截斷。

{
    "base": "EUR",
    "rates": {
        "AED": 4.167972,
        "AFN": 118.91123,
        "ALL": 121.353306,
        "AMD": 546.175542,
        "ANG": 2.035384,
        "AOA": 629.106987,
        "ARS": 116.624363,
        "AUD": 1.580224,
        "AWG": 2.042846,
        "AZN": 1.92923,
        "BAM": 1.95468,
        "BBD": 2.26981,
        "BDT": 97.024176,
        "BGN": 1.956957,
        "BHD": 0.428175,
        "BIF": 2257.462616,
        "BMD": 1.134504,
        "BND": 1.534691,
        "BOB": 7.773946,
        "BRL": 6.394753,
        "BSD": 1.134916,
        "BTC": 0.000027,
        "BTN": 83.896824,
        "BWP": 13.167125,
    }
}

以下是取得USD匯率的請求範例：

GET http://localhost:8080/rates/USD

{
  "base": "USD",
  "rates": {
    "AED": 3.672477643818380310171368756063197,
    "AFN": 104.7748962262571579872079201988508,
    "ALL": 106.9266548068103418652047146893925,
    "AMD": 481.2454276553169780099231576470961,
    "ANG": 1.793414695824643301163693331958788,
    "AOA": 554.3178661774696212335484143830275,
    "ARS": 102.7598951821316197338845611280433,
    "AUD": 1.392364754903645275750470737610812,
    "AWG": 1.799989602800547350872880138793802,
    "AZN": 1.699880432206294535038121596128717,
    "BAM": 1.722304900517304728699178180683942,
    "BBD": 1.999971804204874171858658003508614,
    "BDT": 85.48980589838411660371074286227852,
    "BGN": 1.724311207564226937381544618524109,
    "BHD": 0.3772729555625457630971671155965922,
    "BIF": 1989.092294529751410010035940827599,
    "BMD": 0.9996325735447665520331371082216295
    // omitted
  }
}

限制

• 500 <= salary <= 10000
• sourceCurrency 和 targetCurrency 是 ISO 貨幣代碼（字母）。測試輸入可能包含無效的貨幣代碼。
• 回傳匯率的準確度會計算到小數點後5位。

定義

你必須把程式碼寫在下面的函式裡。

# The exchange rate API base URL
configurable string apiUrl = "http://localhost:8080";

# Convert provided salary to local currency.
#
# + salary - Salary in source currency
# + sourceCurrency - Soruce currency
# + localCurrency - Employee's local currency
# + return - Salary in local currency or error
public function convertSalary(decimal salary, string sourceCurrency, string localCurrency) returns decimal|error {
    // TODO: Write your code here
    return 0;
}

測試環境

• 你可以用bal run執行專案來手動測試，也可以撰寫單元測試並用bal test執行。後端服務會自動在http://localhost:8080啟動

範例

範例 1

輸入：

• 薪資：1000
• 來源貨幣：USD
• 目標貨幣：GBP

輸出：

假設外部貨幣匯率服務回傳了以下的換算匯率回應（已省略）：

{
    "base": "USD",
    "rates": {
        // omitted
        "GBP": 0.73584,
        // omitted
    }
}

這個函式必須回傳735.84000

範例 2

輸入：

• 薪資：1000
• 來源貨幣：GBP
• 目標貨幣：USD

輸出：

假設外部貨幣匯率服務回傳了以下的換算匯率回應（已省略）：

{
    "base": "GBP",
    "rates": {
        // omitted
        "USD": 1.35898,
        // omitted
    }
}

這個函式必須回傳1358.9800

提示

• 你可以把收到的 JSON 回應轉成使用者自訂型別（更精確地說，是開放式 record）以便取用。詳情請見 HTTP 用戶端資料綁定

---

出處

這是一個練習，向使用者介紹如何使用 Ballerina HTTP 服務的資料綁定