Вэб-сэрвіс

Даная тэхналогія з'яўляецца састарэлай. Яе далейшае развіццё не плануецца. рэкамендуем выкарыстоўваць API.

http://www.nbrb.by/Services/ExRates.asmx

Апісанне метадаў вэб-сэрвісу:

Атрыманне афіцыйнага курса беларускага рубля ў дачыненні да замежных валют на пэўную дату,

  • які ўстанаўліваецца штодзённа:
    ExRatesDaily2(ByVal onDate As DateTime) As DataSet
  • які ўстанаўліваецца штомесячна:
    ExRatesMonthly2(ByVal onDate As DateTime) As DataSet

Параметр: onDate – дата ў фармаце System.DateTime, на якую запытваецца курс.

Метад ExRatesDaily вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу DailyExRatesOnDate, метад ExRatesMonthly – аналагічны XML-дакумент, але якi змяшчае табліцу MonthlyExRatesOnDate.

Абедзве табліцы маюць аднолькавую структуру:

  • Cur_Name – найменне валюты
  • Cur_Scale – колькасць адзінак замежнай валюты
  • Cur_OfficialRate – курс
  • Cur_Code – лічбавы код
  • Cur_Abbreviation – літарны код.

DataSet, які вяртаецца, ва ўласцівасці ExtendedProperties утрымлівае элемент з ключом "onDate" і значэннем, роўным даце, на якую атрыманы афіцыйны курс. Для афіцыйнага курса, што ўстанаўліваецца штомесячна, элемент з ключом "onDate" змяшчае дату ўстанаўлення курса, які дзейнічаў на дату, якая запытваецца.

Для атрымання афіцыйнага курса беларускага рубля ў дачыненні да замежных валют на пэўную дату таксама можна карыстацца метадамі ExRatesDaily і ExRatesMonthly, якія маюць аналагічныя ўваходныя параметры і структуру выходнага XML-дакумента, з выняткам поля Cur_Name, заміж якога прысутнічае поле Cur_QuotName, якое ўтрымоўвае імя валюты і колькасць адзінак замежнай валюты.

Поўны пералік замежных валют, у дачыненні да якіх Нацыянальным банкам устанаўліваецца афіцыйны курс беларускага рубля:

  • CurrenciesRef2(ByVal Periodicity As Integer) As DataSet

Параметр Periodicity – перыядычнасць устанаўлення курса (0 – штодня, 1 – штомесяц).

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу DailyCurrenciesRef (Periodicity = 0) або табліцу MonthlyCurrenciesRef (Periodicity = 1). Абедзве табліцы маюць аднолькавую структуру:

  • Cur_Id – унутраны код
  • Cur_ParentID – гэты код выкарыстоўваецца для сувязі, пры змяненнях кодаў або назваў фактычна адной і той жа валюты.
  • Cur_Code – лічбавы код
  • Cur_Abbreviation – літарны код
  • Cur_Name – найменне валюты
  • Cur_Name_Bel – найменне валюты на беларускай мове
  • Cur_Name_Eng – найменне валюты на англійскай мове
  • Cur_QuotName – найменне валюты, якое змяшчае намінал
  • Cur_QuotName_Bel – найменне на беларускай мове, якое змяшчае намінал
  • Cur_QuotName_Eng – найменне на англійскай мове, якое змяшчае намінал
  • Cur_NameMulti– найменне валюты ў множным ліку*
  • Cur_Name_BelMulti – найменне валюты на беларускай мове ў множным ліку*
  • Cur_Name_EngMulti– наименование на англійскай мове ў множным ліку*
  • Cur_Scale – колькасць адзінак замежнай валюты
  • Cur_DateStart – дата ўключэння валюты ў пералік валют, да якіх устанаўліваецца афіцыйны курс беларускага рубля
  • Cur_DateEnd – дата выключэння валюты з пераліку валют, да якіх устанаўліваецца афіцыйны курс беларускага рубля*

Атрыманне дынамікі афіцыйнага курса беларускага рубля ў дачыненні да зададзенай замежнай валюты
(не больш чым за 365 дзён):

  • ExRatesDyn(ByVal сurId As Integer, ByVal fromDate As DateTime, ByVal toDate As DateTime) As DataSet

Параметры:

  • сurId – унутраны код валюты (цэлы лік)
  • fromDate – дата пачатку перыяду, які запытваецца, у фармаце System.DateTime
  • toDate – дата заканчэння перыяду, які запытваецца, у фармаце System.DateTime.

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу Currency. Структура табліцы:

  • Date – дата ўстанаўлення курса
  • Cur_OfficialRate – курс.

DataSet, які вяртаецца, ва ўласцівасці ExtendedProperties змяшчае наступныя элементы:

  • ключ "Id", значэнне – унутраны код валюты
  • ключ "fromDate", значэнне – першая дата, на якую ўстаноўлены курс беларускага рубля да валюты, што запытваецца, унутры перыяду, які запытваецца
  • ключ "toDate", значэнне – апошняя дата, на якую ўстаноўлены курс беларускага рубля да валюты, што запытваецца, унутры перыяду, які запытваецца.

Апошняя дата ўстанаўлення афіцыйнага курса беларускага рубля ў адносінах да замежных валют, на

  • штодзённай аснове:
    LastDailyExRatesDate() As DateTime
  • штомесячнай аснове:
    LastMonthlyExRatesDate() As DateTime

Пачатковая дата ўстанаўлення афіцыйнага курса беларускага рубля ў дачыненні да замежных валют:

  • StartDate (ByVal Periodicity As Integer) As DateTime

Параметр Periodicity – перыядычнасць устанаўлення курса (0 – штодня, 1 – штомесяц).

Атрыманне ўліковых цэн на каштоўныя металы за перыяд (не больш чым за 31 дзень):

  • MetalsPrices(ByVal MetalId As Integer, ByVal fromDate As DateTime, ByVal toDate As DateTime) As DataSet

Параметры:

  • MetalId – унутраны код каштоўнага металу (цэлы лік), калі MetalId=-1, вяртаюцца цэны на ўсе каштоўныя металы
  • fromDate – дата пачатку перыяду, які запытваецца, у фармаце System.DateTime
  • toDate – дата заканчэння перыяду, які запытваецца, у фармаце System.DateTime.

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу AccountPrice.

Структура табліцы AccountPrice:

  • Date – дата ўстанаўлення цаны
  • MetalId – унутраны код каштоўнага металу (цэлы лік)
  • Value – уліковая цана.

DataSet, які вяртаецца, ва ўласцівасці ExtendedProperties змяшчае наступныя элементы:

  • ключ "fromDate", значэнне – першая дата, на якую ўстаноўлены цэны на каштоўныя металы, унутры перыяду, які запытваецца
  • ключ "toDate", значэнне – апошняя дата, на якую ўстаноўлены цэны на каштоўныя металы, унутры перыяду, які запытваецца

Атрыманне пераліку каштоўных металаў, на якія Нацыянальны банк устанаўлівае цэны:

  • MetalsRef() As DataSet

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу MetalsRef.

Структура табліцы MetalsRef:

  • Id – унутраны код каштоўнага металу (цэлы лік)
  • Name – найменне на рускай мове
  • NameBel – найменне на беларускай мове
  • NameEng – найменне на англійскай мове.

Апошняя дата ўстанаўлення ўліковых цэн на каштоўныя металы:

  • MetalsLastDate() As DateTime

Атрыманне цэн на каштоўныя металы ў выглядзе мерных зліткаў на дату:

  • IngotsPrices(ByVal onDate As DateTime) As DataSet

Параметры:

  • onDate – дата ў фармаце System.DateTime, на якую запытваюцца цэны.

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу IngotsPrices.

Структура табліцы IngotsPrices:

  • Date – дата ўстанаўлення цаны
  • MetalId – унутраны код каштоўнага металу (цэлы лік)
  • NoCertificateDollars – цана пакупкі без сертыфіката якасці (у доларах ЗША)*
  • NoCertificateRubles – цана пакупкі без сертыфіката якасці (у беларускіх рублях)*
  • CertificateDollars – цана пакупкі з сертыфікатам якасці (у доларах ЗША)*
  • CertificateRubles – цана пакупкі з сертыфікатам якасці (у беларускіх рублях)*
  • BanksDollars – цана продажу банкам (у доларах ЗША)*
  • BanksRubles – цана продажу банкам (у беларускіх рублях)*
  • EntitiesDollars – цана продажу юрыдычным і фізічным асобам (за выключэннем банкаў, у доларах ЗША)*
  • EntitiesRubles – цана продажу юрыдычным і фізічным асобам (за выключэннем банкаў, у беларускіх рублях)*.

DataSet, які вяртаецца, ва ўласцівасці ExtendedProperties змяшчае наступныя элементы:

  • ключ "onDate", значэнне – дата ўстанаўлення цаны.

Апошняя дата ўстанаўлення цэн на каштоўныя металы ў выглядзе мерных зліткаў:

  • IngotsLastDate () As DateTime

Атрыманне стаўкі рэфінансавання на дату:

  • RefRateOnDate(ByVal onDate As DateTime) As DataSet

Параметры:

  • onDate – дата ў фармаце System.DateTime, на якую запытваецца значэнне стаўкі.

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу RefRate.

Структура табліцы RefRate:

  • Date – дата ўстанаўлення стаўкі
  • Value – значэнне стаўкі.

Дынаміка стаўкі рэфінансавання:

  • RefRateDyn() As DataSet

Метад вяртае XML-дакумент у фармаце System.Data.Dataset, які змяшчае табліцу RefRate.

Структура табліцы RefRate:

  • Date – дата ўстанаўлення стаўкі
  • Value – значэнне стаўкі.

Прыклад работы з вэб-сэрвісам Demo.zip на VB.NET.

* Поле можа прымаць пустое значэнне DbNull.