Сервіси

Курси валют

post

/exchange-rates/conversion

Цей API метод дозволяє отримати курси обміну для різних валют на основі вказаної суми та вашої валюти. Передаючи суму та код валюти, ви можете отримати актуальні курси обміну відносно інших валют. У відповіді повертаються курси для вказаної суми в порівнянні з кожною доступною валютою, що дозволяє переглядати конвертацію валют.

Authorizations

AuthorizationstringRequired

Авторизаційний JWT-токен із терміном дії 1 година в заголовку

Body

amountnumber · floatOptional

Сума коштів для отримання значення за курсом обміну для вказаної валюти. Повинна містити 2 знаки після коми.

Example: 100

countryCodestringOptional

Код країни відправника відповідно до стандарту ISO 3166-1 Alpha-2.

Pattern: ^[A-Z]{2}$

currencyCodestringOptional

Код валюти для отримання курсу обміну відповідно до стандарту ISO 4217.

Pattern: ^[A-Z]{3}$

datestring · date-timeOptional

Дата операції для курсу обміну у форматі ISO 8601.

Example: 2023-10-16T00:00:00Z

Responses

200

shipments

application/json

401

Unauthorized

application/json

404

The specified resource was not found

application/json

422

Validation error

application/json

503

Connection time-out

application/json

post/exchange-rates/conversion

POST /v.1.0/exchange-rates/conversion HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "amount": 100,
  "countryCode": "UA",
  "currencyCode": "USD",
  "date": "2023-10-16T00:00:00.000000Z"
}

{
  "requestCurrency": {
    "currencyCode": "USD",
    "amount": 100
  },
  "mainCurrency": {
    "currencyCode": "UAH",
    "amount": 3662.16
  },
  "convertedCurrencies": [
    {
      "currencyCode": "TND",
      "amount": 317.18
    },
    {
      "currencyCode": "CZK",
      "amount": 2320.03
    },
    {
      "currencyCode": "BRL",
      "amount": 504.08
    },
    {
      "currencyCode": "TRY",
      "amount": 2755.78
    },
    {
      "currencyCode": "RON",
      "amount": 472.25
    },
    {
      "currencyCode": "EUR",
      "amount": 95.02
    },
    {
      "currencyCode": "MDL",
      "amount": 1823.15
    },
    {
      "currencyCode": "ZAR",
      "amount": 1956.6
    },
    {
      "currencyCode": "NZD",
      "amount": 168.27
    },
    {
      "currencyCode": "SAR",
      "amount": 375.59
    },
    {
      "currencyCode": "LYD",
      "amount": 489.62
    },
    {
      "currencyCode": "PLN",
      "amount": 437.49
    },
    {
      "currencyCode": "GBP",
      "amount": 82.31
    }
  ]
}