תחילת העבודה
ממשק ה-API של Finexly מספק שערי חליפין בזמן אמת והיסטוריים עבור יותר מ-170 מטבעות. להתחיל זה פשוט:
- הירשם לחשבון חינם
- קבל את מפתח הגישה ל-API מלוח הבקרה
- בצע את בקשת ה-API הראשונה שלך
כתובת בסיס
https://api.finexly.com/v1/
אימות
כל הבקשות ל-API דורשות אימות באמצעות אסימון Bearer. כלול את מפתח ה-API שלך בכותרת 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 חסר או לא חוקי. |
| 403 | FORBIDDEN | הגישה נדחתה. החשבון שלך עשוי להיות לא פעיל. |
| 413 | PAYLOAD_TOO_LARGE | גודל הבקשה חורג מהגודל המרבי המותר. |
| 429 | RATE_LIMIT_EXCEEDED | חרגת ממגבלת הקצב שלך. בדוק את כותרות X-RateLimit. |
| 500 | INTERNAL_ERROR | אירעה שגיאת שרת פנימית. אנא נסה שוב. |