Web сервис за валутен курс

Back

ТЕХНИЧКО УПАТСТВО за веб-услугата на Народната банка за курсната листа и курсевите за државните органи

На интернет страницата на Народната банка на Република Северна Македонија е достапна апликацијата „веб-услуга“ (англ. web service) наменета за автоматско преземање на податоците од курсната листа во формат „хмл“ (xml) или „џејсон“ (JSON), на следнава адреса:

https://www.nbrm.mk/KLServiceNOV/imenametoda?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml ili json)

или

https://www.nbrm.mk/KLServiceNOV/imenametoda?StartDate=dd-MМM-yyyy&EndDate=dd-MМM-yyyy&format=(xml ili json)

Веб-услугата располагa со четири методи. Првите два се однесуваат на курсната листа, а останатите два на курсевите на НБРСМ при вршење на платениот промет со странство за потребите на државните органи.

Курсна листа:

  1. GetExchangeRate
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRate?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml ili json)
  2. GetExchangeRateD
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRateD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml ili json)

Курсеви на НБРСМ при вршење на платниот промет со странство за потребите на државните органи:

  1. GetExchangeRates
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRates?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml ili json)
  2. GetExchangeRatesD
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRatesD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml ili json)

При повикување на веб-методите: GetExchangeRate и GetExchangeRateD се добива идентичен резултат: курсната листа на Народната банка на Република Северна Македонија. Единствената разлика помеѓу нив е податочниот тип на параметрите коишто им се проследуваат:

1. GetExchangeRate прима два параметра: StartDate и EndDate. И двата параметра треба да бидат во формат на низа {String} и да прикажуваат валиден датум во облик: dd.MM.yyyy (Пример: StartDate=01.02.2010;EndDate=15.02.2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRate?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml%20ili%20json)

2. GetExchangeRateD прима два параметра: StartDate и EndDate. И двата параметра треба да бидат во формат на датум (Date) и да прикажуваат валиден датум. (Пример: StartDate=12-feb-2010; EndDate=15-feb-2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRateD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml%20ili%20json)

Kако резултат нa повикувањето на веб-методите GetExchangeRate и GetExchangeRateD се добива курсната листа, која се состои од следниве полиња:

  1. Поле: RBr вид податоци: double -Реден број на курсната листа
  2. Поле: Datum вид податоци: DateTime - Датум на важење на курсната листа
  3. Поле: Valuta вид податоци: double - Шифра на валутата“
  4. Поле: Nomin вид податоци: double - Единици валута/li>
  5. Поле: Oznaka вид податоци: string - Ознака на валутата<
  6. Поле: Drzava вид податоци: string - Назив на државата - македонски
  7. Поле: DrzavaAng вид податоци: string - Назив на државата - англиски
  8. Поле: DrzavaAl вид податоци: string - Назив на државата - албански
  9. Поле: NazivMak вид податоци: string - Назив на валутата - македонски
  10. Поле: NazivAng вид податоци: string - Назив на валутата - англиски
  11. Поле: NazivAl вид податоци: string - Назив на валутата - албански
  12. Поле: Sreden вид податоци: double - Среден курс во денари
  13. Поле: Datum_f вид податоци: double - Датум на формирање на курсната листа

При повикување на веб-методите: GetExchangeRates и GetExchangeRatesD се враќа идентичен резултат: курсевите на Народната банка при вршење на платниот промет со странство за потребите на државните органи. Единствената разлика помеѓу нив е податочниот тип на параметрите коишто им се проследуваат:

3. GetExchangeRates кој прима два параметра: StartDate и EndDate. И двата параметра треба да бидат во формат на низа (String) и да прикажуваат валиден датум во облик: dd.MM.yyyy (Пример: StartDate=01.02.2010; EndDate=15.02.2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRates?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml%20ili%20json)

4. GetExchangeRatesD кој прима два параметра: StartDate и EndDate.И двата параметра треба да бидат во формат на датум (Date) и да прикажуваат валиден датум. (Пример: StartDate=12-feb-2010; EndDate=15-feb-2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRatesD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml%20ili%20json)

При повикување на веб-методите GetExchangeRates и GetExchangeRatesD, како резултат се добива курсната листа, која се состои од следниве полиња

  1. Поле: RBr вид податоци: double -Реден број на курсната листа
  2. Поле: Datum вид податоци: DateTime - Датум на важење на курсната листа
  3. Поле: Valuta вид податоци: double - Шифра на валутата“
  4. Поле: Nomin вид податоци: double - Единици валута/li>
  5. Поле: Oznaka вид податоци: string - Ознака на валутата<
  6. Поле: Drzava вид податоци: string - Назив на државата - македонски
  7. Поле: DrzavaAng вид податоци: string - Назив на државата - англиски
  8. Поле: DrzavaAl вид податоци: string - Назив на државата - албански
  9. Поле: NazivMak вид податоци: string - Назив на валутата - македонски
  10. Поле: NazivAng вид податоци: string - Назив на валутата - англиски
  11. Поле: NazivAl вид податоци: string - Назив на валутата - албански
  12. Поле: Sreden вид податоци: double - Среден курс во денари
  13. Поле: Kupoven вид податоци: double - Куповен курс во денари
  14. Поле: Prodazen вид податоци: double - Продажен курс во денари
  15. Поле: Datum_f вид податоци: double - Датум на формирање на курсната листа

Доколку се потребни повеќе технички информации за користење на овие методи, ве молиме контактирајте со одговорните лица во Народната банка преку Центарот за ИТ-услуги на следниот телефон: 02/3108555.