Pierwsze kroki
API Finexly dostarcza kursy wymiany w czasie rzeczywistym oraz historyczne dla ponad 170 walut. Rozpoczęcie jest proste:
- Zarejestruj się, aby utworzyć darmowe konto
- Uzyskaj klucz dostępu do API z panelu.
- Wykonaj swoje pierwsze żądanie API
Podstawowy URL
https://api.finexly.com/v1/
Uwierzytelnianie
Wszystkie żądania API wymagają uwierzytelnienia za pomocą tokenu Bearer. Dołącz swój klucz API w nagłówku Authorization:
Opcja 1: Nagłówek autoryzacji (Zalecane)
Nagłówek autoryzacji (wymagany)
Authorization: Bearer YOUR_API_KEY
Opcja 2: Parametr zapytania
Przekaż swój klucz API jako parametr zapytania:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Notatka dotycząca bezpieczeństwa: Klucze API w adresach URL mogą być rejestrowane w logach dostępu serwera i mogą wyciekać przez nagłówki HTTP Referrer. Do użytku produkcyjnego zalecamy metodę nagłówka Authorization. Parametr zapytania jest udostępniany jako udogodnienie do szybkiego testowania i prostych integracji.
Ograniczanie szybkości: Sprawdź nagłówki odpowiedzi, aby zobaczyć swoje bieżące użycie:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Punkty końcowe API
/v1/currencies
Pobierz listę wszystkich obsługiwanych kodów walut.
Parametry
| Nazwa | Rodzaj | Wymagane | Opis |
|---|
Przykład
GET https://api.finexly.com/v1/currencies
// Odpowiedź
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Pobierz kurs wymiany dla określonej pary walut.
Parametry
| Nazwa | Rodzaj | Wymagane | Opis |
|---|---|---|---|
| from | string | Tak | Kod waluty bazowej (wielkimi literami) |
| to | string | Tak | Kod waluty kwotowanej (wielkimi literami) |
Przykład
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Odpowiedź
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Pobierz kursy wymiany dla wielu par walut w jednym żądaniu.
Parametry
| Nazwa | Rodzaj | Wymagane | Opis |
|---|---|---|---|
| q | string | Tak | Pary oddzielone przecinkami w formacie BAZA_KWOTOWANIE |
Przykład
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Odpowiedź
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Przelicz określoną kwotę z jednej waluty na inną.
Parametry
| Nazwa | Rodzaj | Wymagane | Opis |
|---|---|---|---|
| from | string | Tak | Kod waluty źródłowej (wielkimi literami) |
| to | string | Tak | Kod waluty docelowej (wielkimi literami) |
| amount | number | Tak | Kwota do przeliczenia |
Przykład
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Odpowiedź
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Przykłady kodu
# 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")
Kody błędów
| Kod | Rodzaj | Opis |
|---|---|---|
| 400 | BAD_REQUEST | Nieprawidłowe parametry żądania lub brakujące wymagane pola. |
| 401 | UNAUTHORIZED | Brak tokenu API lub nieprawidłowy token. |
| 403 | FORBIDDEN | Dostęp zabroniony. Twoje konto może być nieaktywne. |
| 413 | PAYLOAD_TOO_LARGE | Rozmiar żądania przekracza maksymalny dozwolony rozmiar. |
| 429 | RATE_LIMIT_EXCEEDED | Przekroczono limit szybkości. Sprawdź nagłówki X-RateLimit. |
| 500 | INTERNAL_ERROR | Wystąpił wewnętrzny błąd serwera. Spróbuj ponownie. |
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.