Finantsandmed Eesti ja Soome
turu jaoks.
Üks REST-liides valuutakursside, SEPA pangaregistri, IBAN-i valideerimise, käibemaksumäärade ja kontoandmete jaoks. Vastused alla 100 ms, OpenAPI 3.1 spetsifikatsioon ja OAuth2 client credentials.
Ehitatud tootmiskeskkonnale
Prognoositav latents, läbipaistvad vead ja OpenAPI spetsifikatsioon, mille põhjal saab koodi genereerida.
Valuutakursid
Iga tund värskendatavad viitekursid 30+ valuutale. Upstream'i tõrke korral vastatakse viitetabelist.
SEPA pangaregister
Eesti ja Soome pankade BIC-koodid koos SEPA Instant toe märkega.
IBAN-i valideerimine
ISO 13616 mod-97 kontroll koos riigipõhise pikkuse kontrolliga.
OAuth2 + JWT
Client credentials voog väljastab lühiajalisi JWT-sid. Toetatud RS256/HS256.
RFC 7807 vead
Struktureeritud application/problem+json vastused koos päringu ID-ga.
OpenAPI 3.1
Spetsifikatsioon: /openapi.json, sirvitav /docs all.
Otspunktid
Kõik päringud teenindatakse /v1 alt. JSON sisse, JSON välja.
| Meetod | Tee | Kirjeldus | Autoriseerimine |
|---|---|---|---|
| GET | /v1/health | Elususe kontroll | — |
| GET | /v1/status | Teenuse olek ja tööaeg | — |
| GET | /v1/rates | Valuuta viitekursid | — |
| GET | /v1/quotes/{symbol} | Turunoteering sümbolile | — |
| GET | /v1/markets | Saadaolevad kauplemispaarid | — |
| GET | /v1/banks | SEPA pangaregister (EE/FI) | — |
| GET | /v1/iban/validate | IBAN-i kontroll (mod-97) | — |
| GET | /v1/vat/rates | Käibemaksumäärad | — |
| GET | /v1/holidays | Riiklikud pühad | — |
| GET | /v1/regions | Piirkonnad | — |
| POST | /v1/auth/token | Väljastab juurdepääsutunnuse | — |
| GET | /v1/accounts/{id} | Konto andmed | Bearer |
Alustamine
Kontrolli IBAN-i ühe päringuga.
curl "https://estfin.freepux.site/v1/iban/validate?iban=EE382200221020145685"
Vaheta kliendi andmed juurdepääsutunnuse vastu ja loe konto andmeid:
TOKEN=$(curl -s -X POST https://estfin.freepux.site/v1/auth/token \
-H 'content-type: application/json' \
-d '{"grant_type":"client_credentials","client_id":"demo","client_secret":"supersecret"}' \
| jq -r .access_token)
curl -H "authorization: Bearer $TOKEN" \
https://estfin.freepux.site/v1/accounts/acc_01HXYZ