รายการธุรกรรม

GEThttps://api.omise.co/transactions

ส่งคืนรายการธุรกรรมแบบแบ่งหน้าที่เป็นของบัญชีของคุณ ธุรกรรมแสดงถึงการเคลื่อนไหวของเงินระหว่างบัญชีของคุณและแหล่งการชำระเงินหรือปลายทางการโอน

---

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

แนะนำ - 5 ฟิลด์พารามิเตอร์ที่แนะนำ

▼

`from`STRING(optional)

วันที่และเวลา UTC เริ่มต้นสำหรับบันทึกที่ส่งคืนในรูปแบบ ISO 8601 ใช้เพื่อกรองธุรกรรมที่สร้างในหรือหลังวันที่นี้

Example:"2025-01-01T00:00:00Z"

Default:"1970-01-01T00:00:00Z"

`to`STRING(optional)

วันที่และเวลา UTC สิ้นสุดสำหรับบันทึกที่ส่งคืนในรูปแบบ ISO 8601 ใช้เพื่อกรองธุรกรรมที่สร้างก่อนวันที่นี้

Example:"2025-12-31T23:59:59Z"

`limit`INTEGER(optional)

จำนวนบันทึกที่จะส่งคืนต่อหน้า มีประโยชน์สำหรับการควบคุมขนาดการตอบกลับและประสิทธิภาพ

Example:20

Constraints:ต่ำสุด: 1, สูงสุด: 100

Default:20

`offset`INTEGER(optional)

จำนวนบันทึกที่จะข้ามก่อนส่งคืนผลลัพธ์ ใช้กับ limit สำหรับการแบ่งหน้า

Example:0

Default:0

`order`STRING(optional)

ลำดับการเรียงสำหรับผลลัพธ์ตามเวลาที่สร้าง

Example:"chronological"

Values:chronological, reverse_chronological

Default:"chronological"

---

การตอบกลับ

200

คำขอสำเร็จ

ส่งคืน list object ที่มีข้อมูลธุรกรรมในอาร์เรย์ data

โครงสร้างการตอบกลับ:

• object - ค่า string "list"
• data - อาร์เรย์ของ transaction objects
• limit - จำนวนบันทึกต่อหน้า
• offset - offset ปัจจุบัน
• total - จำนวนธุรกรรมทั้งหมด
• location - เส้นทาง API endpoint

แต่ละ transaction object ประกอบด้วย:

• id - ตัวระบุธุรกรรม (เช่น trxn_test_5fzo4nqrnop03djdde1)
• amount - จำนวนเงินธุรกรรมในหน่วยสกุลเงินที่เล็กที่สุด
• currency - รหัสสกุลเงิน ISO 4217 สามตัวอักษร
• direction - ทิศทางของเงิน (credit หรือ debit)
• key - object ที่เกี่ยวข้องที่ทำให้เกิดธุรกรรม
• origin - แหล่งที่มาเดิมของธุรกรรม
• transferable_at - วันที่เงินสามารถโอนได้
• created_at - timestamp การสร้างธุรกรรม

401

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

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

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

• ไม่มี Authorization header
• Secret key ไม่ถูกต้อง
• ใช้ public key แทน secret key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

5xx

ข้อผิดพลาดเซิร์ฟเวอร์

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

วิธีจัดการ:

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

---

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

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transactions = Omise::Transaction.list

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transactions = omise.Transaction.retrieve()

Node.js

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

const transactions = await omise.transactions.list();

PHP

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

$transactions = OmiseTransaction::retrieve();

Java

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

ScopedList<Transaction> transactions = client.transactions().list();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transactions = await client.Transactions.List();

Go

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

transactions, _ := client.Transactions().List(&operations.ListTransactions{
    Limit: 20,
})

---

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

▼

ทดลองใช้งาน

แนะนำ - 5 ฟิลด์

▼

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