Ξεκινώντας
Το API της Finexly παρέχει συναλλαγματικές ισοτιμίες σε πραγματικό χρόνο και ιστορικά δεδομένα για 170+ νομίσματα. Η έναρξη είναι εύκολη:
- Εγγραφείτε για δωρεάν λογαριασμό
- Λάβετε το κλειδί πρόσβασης API από τον πίνακα ελέγχου
- Κάντε το πρώτο σας αίτημα API
Βασική διεύθυνση URL
https://api.finexly.com/v1/
Ταυτοποίηση
Όλα τα αιτήματα API απαιτούν αυθεντικοποίηση μέσω Bearer token. Συμπεριλάβετε το API key σας στην κεφαλίδα Authorization:
Επιλογή 1: Κεφαλίδα Εξουσιοδότησης (Συνιστάται)
Κεφαλίδα Εξουσιοδότησης (Απαιτείται)
Authorization: Bearer YOUR_API_KEY
Επιλογή 2: Παράμετρος Ερωτήματος
Περάστε το κλειδί API σας ως παράμετρο ερωτήματος:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Σημείωση Ασφαλείας: Τα κλειδιά API στις διευθύνσεις URL μπορεί να καταγραφούν στα αρχεία καταγραφής πρόσβασης του διακομιστή και να διαρρεύσουν μέσω των κεφαλίδων HTTP Referrer. Για χρήση σε παραγωγή, συνιστούμε τη μέθοδο της κεφαλίδας Authorization. Η παράμετρος ερωτήματος παρέχεται για ευκολία σε γρήγορες δοκιμές και απλές ενσωματώσεις.
Περιορισμός Ρυθμού: Ελέγξτε τις κεφαλίδες απόκρισης για την τρέχουσα χρήση σας:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Σημεία Τερματισμού API
/v1/currencies
Λήψη λίστας όλων των υποστηριζόμενων κωδικών νομισμάτων.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|
Παράδειγμα
GET https://api.finexly.com/v1/currencies
// Απάντηση
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Λήψη της συναλλαγματικής ισοτιμίας για ένα συγκεκριμένο ζεύγος νομισμάτων.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| from | string | Ναι | Κωδικός βασικού νομίσματος (κεφαλαία) |
| to | string | Ναι | Κωδικός νομίσματος τιμής (κεφαλαία) |
Παράδειγμα
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Απάντηση
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Λήψη συναλλαγματικών ισοτιμιών για πολλαπλά ζεύγη νομισμάτων σε ένα αίτημα.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| q | string | Ναι | Ζεύγη χωρισμένα με κόμμα σε μορφή BASE_QUOTE |
Παράδειγμα
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Απάντηση
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Μετατροπή συγκεκριμένου ποσού από ένα νόμισμα σε άλλο.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| from | string | Ναι | Κωδικός νομίσματος πηγής (κεφαλαία) |
| to | string | Ναι | Κωδικός νομίσματος στόχου (κεφαλαία) |
| amount | number | Ναι | Ποσό προς μετατροπή |
Παράδειγμα
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Απάντηση
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Παραδείγματα Κώδικα
# 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")
Κωδικοί Σφαλμάτων
| Κωδικός | Τύπος | Περιγραφή |
|---|---|---|
| 400 | BAD_REQUEST | Μη έγκυρες παράμετροι αιτήματος ή απουσιάζουν υποχρεωτικά πεδία. |
| 401 | UNAUTHORIZED | Το API token λείπει ή δεν είναι έγκυρο. |
| 403 | FORBIDDEN | Η πρόσβαση απορρίφθηκε. Ο λογαριασμός σας μπορεί να είναι ανενεργός. |
| 413 | PAYLOAD_TOO_LARGE | Το μέγεθος του αιτήματος υπερβαίνει το μέγιστο επιτρεπόμενο μέγεθος. |
| 429 | RATE_LIMIT_EXCEEDED | Έχετε υπερβεί το όριο ρυθμού σας. Ελέγξτε τα headers X-RateLimit. |
| 500 | INTERNAL_ERROR | Προέκυψε εσωτερικό σφάλμα διακομιστή. Δοκιμάστε ξανά. |