เริ่มต้นใช้งาน
API ของ Finexly ให้บริการอัตราแลกเปลี่ยนแบบเรียลไทม์และประวัติสำหรับสกุลเงินกว่า 170 สกุล การเริ่มต้นใช้งานเป็นเรื่องง่าย:
- สมัครบัญชีฟรี
- รับคีย์การเข้าถึง API ของคุณจากแดชบอร์ด
- ทำการร้องขอ API ครั้งแรกของคุณ
URL พื้นฐาน
https://api.finexly.com/v1/
การยืนยันตัวตน
การร้องขอ API ทั้งหมดต้องมีการยืนยันตัวตนผ่าน Bearer token รวมคีย์ 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 headers สำหรับการใช้งานในระบบผลิตจริง เราแนะนำให้ใช้วิธี Authorization header พารามิเตอร์ query ถูกจัดให้เพื่อความสะดวกในการทดสอบอย่างรวดเร็วและการผสานรวมที่ง่ายดาย
การจำกัดอัตรา: ตรวจสอบส่วนหัวของการตอบสนองสำหรับการใช้งานปัจจุบันของคุณ:
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 | Token API หายไปหรือไม่ถูกต้อง |
| 403 | FORBIDDEN | การเข้าถึงถูกปฏิเสธ บัญชีของคุณอาจไม่ได้ใช้งาน |
| 413 | PAYLOAD_TOO_LARGE | ขนาดคำขอเกินขนาดสูงสุดที่อนุญาต |
| 429 | RATE_LIMIT_EXCEEDED | คุณเกินขีดจำกัดอัตรา ตรวจสอบ headers X-RateLimit |
| 500 | INTERNAL_ERROR | เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์ กรุณาลองอีกครั้ง |
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.