Memulakan
API Finexly menyediakan kadar pertukaran masa nyata dan sejarah untuk lebih 170 mata wang. Memulakan adalah mudah:
- Daftar untuk akaun percuma
- Dapatkan kunci akses API anda dari papan pemuka
- Buat permintaan API pertama anda
URL Asas
https://api.finexly.com/v1/
Pengesahan
Semua permintaan API memerlukan pengesahan melalui token Bearer. Sertakan kunci API anda dalam header Authorization:
Pilihan 1: Tajuk Kebenaran (Disyorkan)
Pengepala Kebenaran (Diperlukan)
Authorization: Bearer YOUR_API_KEY
Pilihan 2: Parameter Pertanyaan
Lalukan kunci API anda sebagai parameter pertanyaan:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Nota Keselamatan: Kunci API dalam URL mungkin direkod dalam log akses pelayan dan boleh bocor melalui header HTTP Referrer. Untuk penggunaan produksi, kami mengesyorkan kaedah header Authorization. Parameter kueri disediakan sebagai kemudahan untuk ujian pantas dan integrasi mudah.
Pengehadan Kadar: Semak pengepala respons untuk penggunaan semasa anda:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Titik Akhir API
/v1/currencies
Dapatkan senarai semua kod mata wang yang disokong.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|
Contoh
GET https://api.finexly.com/v1/currencies
// Respons
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Dapatkan kadar pertukaran untuk pasangan mata wang tertentu.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| from | string | Ya | Kod mata wang asas (huruf besar) |
| to | string | Ya | Kod mata wang sebut harga (huruf besar) |
Contoh
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Respons
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Dapatkan kadar pertukaran untuk berbilang pasangan mata wang dalam satu permintaan.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| q | string | Ya | Pasangan dipisahkan koma dalam format BASE_QUOTE |
Contoh
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Respons
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Tukar jumlah tertentu dari satu mata wang ke mata wang lain.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| from | string | Ya | Kod mata wang sumber (huruf besar) |
| to | string | Ya | Kod mata wang sasaran (huruf besar) |
| amount | number | Ya | Jumlah untuk ditukar |
Contoh
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Respons
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Contoh Kod
# 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")
Kod Ralat
| Kod | Jenis | Penerangan |
|---|---|---|
| 400 | BAD_REQUEST | Parameter permintaan tidak sah atau medan wajib tiada. |
| 401 | UNAUTHORIZED | Token API tiada atau tidak sah. |
| 403 | FORBIDDEN | Akses dinafikan. Akaun anda mungkin tidak aktif. |
| 413 | PAYLOAD_TOO_LARGE | Saiz permintaan melebihi saiz maksimum yang dibenarkan. |
| 429 | RATE_LIMIT_EXCEEDED | Anda telah melebihi had kadar anda. Semak pengepala X-RateLimit. |
| 500 | INTERNAL_ERROR | Ralat pelayan dalaman berlaku. Sila cuba lagi. |