Kursi i kembimit (v1) — fature.al API

Kursi i kembimit

GET /api/v1/exchange-rates Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Kthen kursin e shitjes se dites per cdo monedhe, sipas burimit te zgjedhur. Te dhenat vijne nga https://api.kursi.al/api/rates dhe ruhen ne cache per nje ore ne server, prandaj klienti mund ta mbaje snapshot-in e fundit lokalisht dhe te punoje edhe pa internet.

Burimet e mbeshtetura (vlera source ne kerkese):

BOA -> Banka e Shqiperise (kursi zyrtar)
BKT -> Banka Kombetare Tregtare
Iliria98 -> Kembim Valutor "Iliria '98"
ADON -> Kembim Valutor "Adon"

Nje burim i papercaktuar kthehet automatikisht ne BOA. Fusha source ne pergjigje eshte gjithmone vlera e normalizuar.

Full URL: https://fature.al/api/v1/exchange-rates

Query parameters

Name	Type	Required	Description
source	string	no	Burimi i kursit: BOA, BKT, Iliria98 ose ADON. Defaults to `BOA`.

Responses

200 OK

Field	Type	Description
status	boolean
data	object
data.rates	object
data.source	string
data.fetchedAt	string

Example request

cURL

curl -X GET 'https://fature.al/api/v1/exchange-rates' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
])->get('https://fature.al/api/v1/exchange-rates');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/exchange-rates', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

JavaScript

const response = await fetch('https://fature.al/api/v1/exchange-rates', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Example response

200

{
    "status": true,
    "data": {
        "rates": [],
        "source": "source",
        "fetchedAt": "fetchedAt"
    }
}

This page as Markdown, or the whole API as OpenAPI.