Dokumentacja
Pobieranie kwotowań
Notowania walut pobieramy przy użyciu HTTP GET. Każde zapytanie musi zawierać jako parametr klucz autoryzacyjny. Przykładowe zapytanie przy użyciu narzędzia Curl:
curl "https://api.feedler.pl/quotations?key=example"
Przykładowa odpowiedź, gdzie example jest kluczem otrzymanym przy zamawianiu usługi:
[ { "symbol": "BTCPLN", "bid": "27941.71000", "ask": "27994.99000", "time": "2018-07-23T13:16:39+02:00" }, { "symbol": "EURPLN", "bid": "4.25380", "ask": "4.28380", "time": "2019-07-12T19:19:04+02:00" } ]
Jeśli oprogramowanie po stronie klienta nie obsługuje szyfrowania HTTPS można użyć protokołu HTTP:
curl "http://api.feedler.pl/quotations?key=example"
Dostępne formaty
Standardowo dostępne są następujące formaty: json, csv, xml. Jeśli potrzebujesz otrzymać dane w formie innej niż domyślna (JSON), zapytanie powinno zawierać dodatkowy parametr format, na przykład:
curl "https://api.feedler.pl/quotations?key=example&format=csv"
Przykładowa odpowiedź w formacie CSV:
EURPLN,4.25380,4.28380,4.26880,2019-07-12T19:19:04+02:00
Analogicznie dla XML:
curl "https://api.feedler.pl/quotations?key=example&format=xml"
Przykładowa odpowiedź w formacie XML:
<?xml version="1.0" encoding="utf-8" ?> <quotations> <quotation> <symbol>EURPLN</symbol> <bid>4.25380</bid> <ask>4.28380</ask> <mid>4.26880</mid> <time>2019-07-12T19:19:04+02:00</time> </quotation> </quotations>
Formaty niestandardowe
Jeśli zamówiłeś otrzymywanie kwotowań w ramach indywidualnej oferty z niestandardowym formatem odpowiedzi serwera użyj formatu otrzymanego w ramach zamówienia w parametrze format.
Kwotowania NBP oraz banków
Jeśli zamówiłeś dostęp do kwotowań NBP oraz międzybankowych możesz je pobrać poprzez ustawienie parametru kind odpowiednio na wartość nbp lub interbank. Przykładowo, pobrania kursów NBP możesz dokonać poprzez zapytanie:
curl "https://api.feedler.pl/quotations?key=example&format=json&kind=nbp"
Natomiast kursów międzybankowych poprzez zapytanie:
curl "https://api.feedler.pl/quotations?key=example&format=json&kind=interbank"
W przypadku zapytania o kursy międzybankowe należy zwrócić uwagę, że zwracana odpowiedź zawiera dodatkowe pole source wskazujące na bank z którego pochodzi dane kwotowanie.