Дата: 07.07.2017

Курси валют


Основне посилання: http://ucci-service.org/api/v1

Дані методи дозволять  Вам отримати інофрмацію стосовно офіційних курсів валют


/currency/exchange

Метод дозволяє отриати інформацію стосовно курсів валют

Параметри
 Параметр  Приклад  Обов'язковий  Опис
 format  json,xml  ні  Бажаний формат відповіді
 api_key  xxxxxxxxx  так  API ключ додатку
 exchangedate  20172206,20162206  ні   Дата у форматі YYYYMMDD
 code_abc  USD,EUR  ні   Літерний код валюти
Приклади
  • Запит на отримання інформації стосовно усіх курсів валют на сьогодні у форматі xml

    http://ucci-service.org/api/v1/currency/exchange?format=xml&api_key=12345

    Відповідь

    <?xml version="1.0" encoding="utf-8"?>
    <result>
      <ok>true</ok>
      <exchange>
        <currency>
          <code_num>985</code_num>
          <code_abc>PLN</code_abc>
          <rate>6.87253300</rate>
          <exchangedate>2017-06-26</exchangedate>
        </currency>
        <currency>
          <code_num>986</code_num>
          <code_abc>BRL</code_abc>
          <rate>8.09177100</rate>
          <exchangedate>2017-06-26</exchangedate>
        </currency>
      </exchange>
    </result>
  • Запит на отримання інформації стосовно усіх курсів валют на зазначену дату в форматі json

    http://ucci-service.org/api/v1/currency/exchange?api_key=12345&exchangedate=20170622

    Відповідь

    { 
      "ok": true,
      "currencies": [
        {
          "code_num": 12,
          "code_abc": "DZD",
          "rate": 0.242782,
          "exchangedate": "2017-06-22T00:00:00"
        },
        {
          "code_num": 944,
          "code_abc": "AZN",
          "rate": 15.458481,
          "exchangedate": "2017-06-22T00:00:00"
        }
      ]
    }
  • Запит на отримання інформації стосовно курсу зазначенної валюти на согодні у форматі json

    http://ucci-service.org/api/v1/currency/exchange?api_key=12345&code_abc=USD

    Відповідь

    {
      "ok": true,
      "currencies": [
        {
          "code_num": 840,
          "code_abc": "USD",
          "rate": 26.025695,
          "exchangedate": "2017-06-23T00:00:00"
        }
      ]
    }
  • Запит на отримання інформації стосовно курсу зазначенної валюти на зазначену дату у форматі xml

    http://ucci-service.org/api/v1/currency/exchange?format=xml&api_key=12345&exchangedate=20170622&code_abc=USD

    Відповідь

    <?xml version="1.0" encoding="utf-8"?>
    <result>
      <ok>true</ok>
      <exchange>
        <currency>
          <code_num>840</code_num>
          <code_abc>USD</code_abc>
          <rate>26.02360200</rate>
          <exchangedate>2017-06-22</exchangedate>
        </currency>
      </exchange>
    </result>
Помилки

У випадку помилкого запиту, у відповідь Ви отримаєте повідомлення з описом помилки

{
  "ok": false,
  "message": "Error: client_id is required"
}

або

<?xml version="1.0" encoding="utf-8"?>
<result>
    <ok>false</ok>
    <message>no such currency</message>
</result>