ดึงข้อมูลอัตราแลกเปลี่ยน

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

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

---

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

▼

---

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

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

▼

`currency`STRING(required)

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

Example:"usd"

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

---

การตอบกลับ

200

คำขอสำเร็จ

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

ออบเจ็กต์ Forex ประกอบด้วย:

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

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

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

401

ไม่ได้รับอนุญาต

การยืนยันตัวตนล้มเหลว คีย์ API ไม่ถูกต้องหรือขาดหายไป

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

• ขาดหัวข้อ Authorization
• คีย์ลับไม่ถูกต้อง
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

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

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

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

---

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

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")

---

ลองใช้งาน

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

▼

currency(จำเป็น)