Сервіси

Курси валют

post

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/exchange-rates/conversion

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

🔹Опис елементів керування:

SCHEMA

Відображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.

• Single line description Опис, що вміщується в один рядок; текст, який не поміщається, залишається прихованим.

• Multiline description Розширений опис, що відображає більше одного рядка тексту.

EXAMPLE

Показує готовий приклад JSON із правильно сформованими значеннями для демонстрації того, як має виглядати валідний запит або відповідь.

Authorizations

JWT

AuthorizationstringRequired

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

Body

application/json

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

HTTPcURLJavaScriptPython

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
    }
  ]
}