Első lépések
A Finexly API valós idejű és történelmi árfolyamokat biztosít több mint 170 valutához. A kezdés egyszerű:
- Regisztráljon ingyenes fiókot
- Szerezze be az API hozzáférési kulcsot a vezérlőpultról
- Küldje el első API-kérését
Alap URL
https://api.finexly.com/v1/
Hitelesítés
Minden API-kérés hitelesítést igényel Bearer tokenen keresztül. Az API kulcsot az Authorization fejlécben kell megadni:
1. lehetőség: Engedélyezési fejléc (Ajánlott)
Hitelesítési fejléc (Kötelező)
Authorization: Bearer YOUR_API_KEY
2. lehetőség: Lekérdezési paraméter
Adja meg az API-kulcsot lekérdezési paraméterként:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Biztonsági megjegyzés: Az API kulcsok URL-ekben naplózódhatnak a szerver hozzáférési naplóiban, és kiszivároghatnak a HTTP Referrer fejléceken keresztül. Éles használatra az Authorization fejléc módszert javasoljuk. A lekérdezési paraméter kényelmi okokból van biztosítva gyors teszteléshez és egyszerű integrációkhoz.
Korlátozás: Ellenőrizze a válaszfejléceket az aktuális használatért:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API végpontok
/v1/currencies
Az összes támogatott devizakód listájának lekérése.
Paraméterek
| Név | Típus | Kötelező | Leírás |
|---|
Példa
GET https://api.finexly.com/v1/currencies
// Válasz
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Árfolyam lekérése egy adott devizapárhoz.
Paraméterek
| Név | Típus | Kötelező | Leírás |
|---|---|---|---|
| from | string | Igen | Alapdeviza kód (nagybetűk) |
| to | string | Igen | Jegyzett deviza kód (nagybetűk) |
Példa
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Válasz
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Árfolyamok lekérése több devizapárhoz egyetlen kérésben.
Paraméterek
| Név | Típus | Kötelező | Leírás |
|---|---|---|---|
| q | string | Igen | Vesszővel elválasztott párok ALAP_JEGYZETT formátumban |
Példa
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Válasz
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Adott összeg átváltása egyik devizából a másikba.
Paraméterek
| Név | Típus | Kötelező | Leírás |
|---|---|---|---|
| from | string | Igen | Forrás deviza kód (nagybetűk) |
| to | string | Igen | Cél deviza kód (nagybetűk) |
| amount | number | Igen | Átváltandó összeg |
Példa
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Válasz
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Kódpéldák
# Using Authorization header (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/rate?from=USD&to=EUR"
# Using query parameter
curl "https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY"
# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP"
# Convert amount
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100"
<?php
$apiKey = 'YOUR_API_KEY';
// Using cURL
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.finexly.com/v1/rate?from=USD&to=EUR',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo "USD/EUR Rate: " . $data['rate'];
const apiKey = 'YOUR_API_KEY';
// Get single rate
const response = await fetch('https://api.finexly.com/v1/rate?from=USD&to=EUR', {
headers: {
'Authorization': `Bearer ${apiKey}`
}
});
const data = await response.json();
console.log(`USD/EUR Rate: ${data.rate}`);
// Convert amount
const convertResponse = await fetch(
'https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100',
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const result = await convertResponse.json();
console.log(`100 USD = ${result.result} EUR`);
import requests
api_key = 'YOUR_API_KEY'
headers = {'Authorization': f'Bearer {api_key}'}
# Get single rate
response = requests.get(
'https://api.finexly.com/v1/rate',
params={'from': 'USD', 'to': 'EUR'},
headers=headers
)
data = response.json()
print(f"USD/EUR Rate: {data['rate']}")
# Convert amount
response = requests.get(
'https://api.finexly.com/v1/convert-amount',
params={'from': 'USD', 'to': 'EUR', 'amount': 100},
headers=headers
)
result = response.json()
print(f"100 USD = {result['result']} EUR")
Hibakódok
| Kód | Típus | Leírás |
|---|---|---|
| 400 | BAD_REQUEST | Érvénytelen kérési paraméterek vagy hiányzó kötelező mezők. |
| 401 | UNAUTHORIZED | API token hiányzik vagy érvénytelen. |
| 403 | FORBIDDEN | Hozzáférés megtagadva. Fiókja lehet, hogy inaktív. |
| 413 | PAYLOAD_TOO_LARGE | A kérés mérete meghaladja a maximálisan engedélyezett méretet. |
| 429 | RATE_LIMIT_EXCEEDED | Túllépte a sebességkorlátot. Ellenőrizze az X-RateLimit fejléceket. |
| 500 | INTERNAL_ERROR | Belső szerverhiba történt. Kérjük, próbálja újra. |
Tutorials & Guides
Learn how to integrate Finexly with your favorite programming languages and frameworks.
JavaScript Integration Tutorial
Step-by-step guide to integrating Finexly API with JavaScript and Node.js.
Python Integration Tutorial
Complete guide to using Finexly API with Python and popular libraries.
Developer Guide
Comprehensive guide to free currency API features and best practices.
Historical Rates Guide
Learn how to retrieve and work with historical exchange rate data.