ดึงอัตราแลกเปลี่ยน Forex

GEThttps://api.omise.co/forex/:currency

ดึงอัตราแลกเปลี่ยนปัจจุบันสำหรับคู่สกุลเงินที่ระบุ ส่งคืนอัตราแลกเปลี่ยนแบบ real-time ที่ใช้สำหรับธุรกรรมหลายสกุลเงิน Endpoint นี้สามารถเข้าถึงได้เฉพาะเมื่อเปิดใช้งานธุรกรรมหลายสกุลเงินในบัญชีของคุณ

---

พารามิเตอร์คำขอ

จำเป็น - 1 รายการพารามิเตอร์ที่จำเป็น

▼

`currency`STRING(required)

สกุลเงินฐานเป็นรหัส ISO 4217 สามตัวอักษรพิมพ์เล็ก อัตราจะแสดงการแปลงจากสกุลเงินนี้ไปยังสกุลเงินที่ใช้ชำระของบัญชี

Example:"usd"

Values:thb, jpy, sgd, myr, usd, eur, gbp

---

การตอบกลับ

200

คำขอสำเร็จ

ส่งคืน forex object พร้อมข้อมูลอัตราแลกเปลี่ยนปัจจุบัน

Forex object ประกอบด้วย:

• object - ค่าสตริง "forex"
• location - เส้นทาง API endpoint (เช่น "/forex/usd")
• livemode - Boolean ระบุ test หรือ live mode
• base - รหัสสกุลเงินต้นทาง (ISO 4217)
• quote - รหัสสกุลเงินปลายทาง (โดยทั่วไปเป็นสกุลเงินที่ใช้ชำระของบัญชี)
• rate - อัตราแลกเปลี่ยนตัวเลข (ประมาณ 2-4% สูงกว่าอัตรากลางตลาดรายวัน)

การคำนวณอัตรา:

• อัตราแสดงว่าสกุลเงินปลายทางเท่ากับหนึ่งหน่วยของสกุลเงินฐาน
• ตัวอย่าง: ถ้า base=USD, quote=THB, rate=30.4847 แล้ว 1 USD = 30.4847 THB
• อัตรารวมมาร์จิ้นของ Omise (2-4% สูงกว่าอัตรากลางตลาด)

401

Unauthorized

การยืนยันตัวตนล้มเหลว API key ไม่ถูกต้องหรือหายไป

สาเหตุทั่วไป:

• ขาด Authorization header
• Secret key ไม่ถูกต้อง
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

Not found

ไม่พบสกุลเงินหรือไม่ได้เปิดใช้งานหลายสกุลเงิน

สาเหตุทั่วไป:

• รหัสสกุลเงินไม่ถูกต้อง
• ธุรกรรมหลายสกุลเงินไม่ได้เปิดใช้งานในบัญชี
• สกุลเงินไม่รองรับสำหรับบัญชีของคุณ

5xx

Server error

เกิดข้อผิดพลาดฝั่งเซิร์ฟเวอร์ สิ่งเหล่านี้หายากแต่ควรจัดการอย่างเหมาะสม

วิธีจัดการ:

• ลอง request ใหม่ด้วย exponential backoff
• ตรวจสอบ status.omise.co สำหรับเหตุการณ์บริการ
• ดู การจัดการข้อผิดพลาด สำหรับคำแนะนำโดยละเอียด

---

ตัวอย่างโค้ด

cURL

curl https://api.omise.co/forex/usd \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

forex = Omise::Forex.retrieve('usd')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

forex = omise.Forex.retrieve('usd')

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const forex = await omise.forex.retrieve('usd');

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$forex = OmiseForex::retrieve('usd');

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

ForexRate forex = client.forex("usd").get();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var forex = await client.Forex.Retrieve("usd");

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

forex, _ := client.Forex().Get("usd")

---

🔑ข้อมูลยืนยันตัวตน API

▼

ลองใช้งาน

จำเป็น - 1 ฟิลด์

▼

currency(จำเป็น)

IP ของคุณ: ...กำลังโหลด...