Başlarken
Finexly API, 170'den fazla para birimi için gerçek zamanlı ve geçmiş döviz kurları sağlar. Başlamak kolaydır:
- Ücretsiz bir hesap oluşturun
- API erişim anahtarınızı kontrol panelinden alın
- İlk API isteğinizi yapın
Temel URL
https://api.finexly.com/v1/
Kimlik Doğrulama
Tüm API istekleri, Bearer token ile kimlik doğrulaması gerektirir. API anahtarınızı Authorization başlığına ekleyin:
Seçenek 1: Yetkilendirme Başlığı (Önerilen)
Yetkilendirme Başlığı (Gerekli)
Authorization: Bearer YOUR_API_KEY
Seçenek 2: Sorgu Parametresi
API anahtarınızı bir sorgu parametresi olarak geçirin:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Güvenlik Notu: URL'lerdeki API anahtarları, sunucu erişim günlüklerinde kaydedilebilir ve HTTP Referrer başlıkları aracılığıyla sızabilir. Üretim kullanımı için, Authorization başlık yöntemini öneriyoruz. Sorgu parametresi, hızlı testler ve basit entegrasyonlar için bir kolaylık olarak sağlanmıştır.
Oran Sınırlandırma: Mevcut kullanımınızı kontrol etmek için yanıt başlıklarına bakın.
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API Uç Noktaları
/v1/currencies
Desteklenen tüm para birimi kodlarının listesini alın.
Parametreler
| Ad | Türü | Gerekli | Açıklama |
|---|
Örnek
GET https://api.finexly.com/v1/currencies
// Yanıt
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Belirli bir döviz çifti için döviz kurunu alın.
Parametreler
| Ad | Türü | Gerekli | Açıklama |
|---|---|---|---|
| from | string | Evet | Temel para birimi kodu (büyük harf) |
| to | string | Evet | Karşıt para birimi kodu (büyük harf) |
Örnek
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Yanıt
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Tek bir istekte birden fazla döviz çifti için döviz kurlarını alın.
Parametreler
| Ad | Türü | Gerekli | Açıklama |
|---|---|---|---|
| q | string | Evet | BASE_QUOTE formatında virgülle ayrılmış çiftler |
Örnek
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Yanıt
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Belirli bir tutarı bir para biriminden diğerine dönüştürün.
Parametreler
| Ad | Türü | Gerekli | Açıklama |
|---|---|---|---|
| from | string | Evet | Kaynak para birimi kodu (büyük harf) |
| to | string | Evet | Hedef para birimi kodu (büyük harf) |
| amount | number | Evet | Dönüştürülecek tutar |
Örnek
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Yanıt
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Kod Örnekleri
# 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")
Hata Kodları
| Kod | Türü | Açıklama |
|---|---|---|
| 400 | BAD_REQUEST | Geçersiz istek parametreleri veya eksik zorunlu alanlar. |
| 401 | UNAUTHORIZED | API token'ı eksik veya geçersiz. |
| 403 | FORBIDDEN | Erişim reddedildi. Hesabınız aktif olmayabilir. |
| 413 | PAYLOAD_TOO_LARGE | İstek boyutu izin verilen maksimum boyutu aşıyor. |
| 429 | RATE_LIMIT_EXCEEDED | Hız limitinizi aştınız. X-RateLimit başlıklarını kontrol edin. |
| 500 | INTERNAL_ERROR | Dahili sunucu hatası oluştu. Lütfen tekrar deneyin. |