การค้นหาทั่วไป

GEThttps://api.omise.co/search

ค้นหาขอบเขตของข้อมูลตามพารามิเตอร์ที่ป้อน ใช้ endpoint นี้เพื่อทำการค้นหาแบบ full-text และ query ที่มีตัวกรองข้าม charges, customers, disputes, recipients และทรัพยากรอื่นๆ

---

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

จำเป็น - 1 ฟิลด์พารามิเตอร์ที่จำเป็น

▼

`scope`STRING(required)

ประเภทข้อมูลที่จะค้นหา กำหนดว่าจะค้นหาประเภททรัพยากรใดและตัวกรองใดที่ใช้ได้

Example:"charge"

Values:audit, charge, charge_schedule, customer, dispute, event, link, linked_account, log_entry, receipt, recipient, refund, sub_merchant, transfer, transfer_schedule, transaction

แนะนำ - 4 ฟิลด์พารามิเตอร์แนะนำ

▼

`query`STRING(optional)

ข้อความค้นหาสำหรับการค้นหาแบบ full-text ค้นหาใน ID, คำอธิบาย, metadata, อีเมล และชื่อ ขึ้นอยู่กับ scope

Example:"john@example.com"

`filters`OBJECT(optional)

ตัวกรองการค้นหาเพื่อจำกัดผลลัพธ์ ตัวกรองที่ใช้ได้ขึ้นอยู่กับ scope ตัวกรองทั่วไปรวมถึง status, amount, ช่วงวันที่สร้าง

Example:{"created":"2019/01/01..2019/12/31"}

`order`STRING(optional)

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

Example:"chronological"

Values:chronological, reverse_chronological

Default:"chronological"

`page`INTEGER(optional)

หมายเลขหน้าสำหรับการแบ่งหน้า (เริ่มจาก 1)

Example:1

Default:1

เพิ่มเติม - 1 ฟิลด์พารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

ค้นหาสำเร็จ

ส่งคืนออบเจกต์การค้นหาที่มีผลลัพธ์แบบแบ่งหน้าในอาร์เรย์ data

โครงสร้าง Response:

• object - ค่าสตริง "search"
• location - เส้นทาง API endpoint
• data - อาร์เรย์ของออบเจกต์ที่ตรงกับ scope (เรียงย้อนกลับตามเวลาโดยค่าเริ่มต้น)
• page - หมายเลขหน้าปัจจุบัน
• per_page - จำนวนรายการต่อหน้า
• total - จำนวนรายการทั้งหมดที่ตรงกับ query
• total_pages - จำนวนหน้าทั้งหมด
• filters - ตัวกรองการค้นหาที่ใช้
• query - คำค้นหาที่ใช้
• scope - ประเภททรัพยากรที่ค้นหา
• order - การเรียงลำดับผลลัพธ์ที่ใช้
• aggregate_level - ระดับลำดับชั้นสำหรับดึงข้อมูล sub-merchants
• export - ตัวระบุการส่งออก (ขยายได้)

หมายเหตุเกี่ยวกับการแบ่งหน้า:

• ใช้ page และ per_page (แตกต่างจาก endpoints รายการมาตรฐาน)
• ส่งผลลัพธ์เรียงย้อนกลับตามเวลาโดยค่าเริ่มต้น
• รองรับสูงสุด 100 ผลลัพธ์ต่อหน้า

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว ตรวจสอบข้อความ error สำหรับรายละเอียด

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

• ขาดพารามิเตอร์ scope ที่จำเป็น
• ค่า scope ไม่ถูกต้อง
• ออบเจกต์ filters ไม่ถูกต้อง
• รูปแบบวันที่ในตัวกรองไม่ถูกต้อง

401

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

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

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

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

5xx

เซิร์ฟเวอร์ error

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/search \
  -X GET \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "scope=charge" \
  -d "query=thb" \
  -d "filters[created]=2019/01/01..2019/12/31"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

search = Omise::Search.execute(
  'charge',
  query: 'thb',
  filters: { created: '2019/01/01..2019/12/31' }
)

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

search = omise.Search.execute(
    'charge',
    query='thb',
    filters={'amount': '1000..2000', 'captured': 'true'}
)

Node.js

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

const search = await omise.search.list({
  scope: 'charge',
  query: 'thb',
  filters: {
    created: '2019/01/01..2019/12/31'
  }
});

PHP

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

$search = OmiseSearch::execute([
    'scope' => 'charge',
    'query' => 'thb',
    'filters' => [
        'created' => '2019/01/01..2019/12/31'
    ]
]);

Java

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

SearchResult<Charge> search = client.search()
    .scope(SearchScope.Charge)
    .query("thb")
    .filter("created", "2019/01/01..2019/12/31")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var search = await client.Search.Execute(new SearchRequest
{
    Scope = "charge",
    Query = "thb",
    Filters = new Dictionary<string, object>
    {
        { "created", "2019/01/01..2019/12/31" }
    }
});

Go

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

search, _ := client.Search(&operations.SearchOptions{
    Scope: "charge",
    Query: "thb",
    Filters: map[string]interface{}{
        "created": "2019/01/01..2019/12/31",
    },
})

---

รหัส Error และผลลัพธ์

รูปแบบตัวกรองทั่วไป

รูปแบบตัวกรอง	คำอธิบาย	ตัวอย่าง
field=value	ตรงกันแบบแน่นอน	status=successful
field=val1..val2	ช่วง	amount=1000..5000
field=date..date	ช่วงวันที่	created=2019/01/01..2019/12/31
field=true/false	บูลีน	captured=true

ตัวกรองที่ใช้ได้ตาม Scope

Charge scope:

• status - successful, failed, pending, expired
• amount - จำนวนเงินที่ตรงกันหรือช่วง (1000..5000)
• captured - true/false
• created - ช่วงวันที่ (2019/01/01..2019/12/31)

Customer scope:

• created - ช่วงวันที่

Dispute scope:

• status - open, pending, won, lost
• created - ช่วงวันที่

Recipient scope:

• active - true/false
• verified - true/false

---

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

▼

ลองใช้งาน

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

▼

scope(จำเป็น)

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

▼

เพิ่มเติม - 1 ฟิลด์

▼

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