เริ่มต้นใช้งาน
API ของ Finexly ให้บริการอัตราแลกเปลี่ยนแบบเรียลไทม์และประวัติสำหรับสกุลเงินกว่า 170 สกุล การเริ่มต้นใช้งานเป็นเรื่องง่าย:
- สมัครบัญชีฟรี
- รับคีย์การเข้าถึง API ของคุณจากแดชบอร์ด
- ทำการร้องขอ API ครั้งแรกของคุณ
URL พื้นฐาน
https://api.finexly.com/v1/
การยืนยันตัวตน
การร้องขอ API ทั้งหมดต้องมีการยืนยันตัวตนผ่าน Bearer token รวมคีย์ API ของคุณในส่วนหัว Authorization:
ส่วนหัวการอนุญาต (จำเป็น)
Authorization: Bearer YOUR_API_KEY
การจำกัดอัตรา: ตรวจสอบส่วนหัวของการตอบสนองสำหรับการใช้งานปัจจุบันของคุณ:
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
}
ตัวอย่างโค้ด
# Get single rate
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/rate?from=USD&to=EUR"
# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP,BTC_USD"
# 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 | Token API หายไปหรือไม่ถูกต้อง |
| 403 | FORBIDDEN | การเข้าถึงถูกปฏิเสธ บัญชีของคุณอาจไม่ได้ใช้งาน |
| 413 | PAYLOAD_TOO_LARGE | ขนาดคำขอเกินขนาดสูงสุดที่อนุญาต |
| 429 | RATE_LIMIT_EXCEEDED | คุณเกินขีดจำกัดอัตรา ตรวจสอบ headers X-RateLimit |
| 500 | INTERNAL_ERROR | เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์ กรุณาลองอีกครั้ง |