ข้ามไปยังเนื้อหาหลัก

REST API

ดึงประวัติการตรวจสลิป

ดึงรายการตรวจสลิปย้อนหลังของร้านค้า รองรับการแบ่งหน้า กรองตามสถานะ เลขอ้างอิงรายการ และช่วงวันที่ ข้อมูลจะถูกจำกัดอยู่เฉพาะร้านค้าของ API Key ที่ใช้เรียกเสมอ

GET/api/slip-history

การคิดโทเคน

ไม่หักโทเคน เป็นการอ่านข้อมูลที่บันทึกไว้แล้ว

พารามิเตอร์

รูปแบบข้อมูลที่ส่งเข้ามา:

Headers

ฟิลด์ชนิดข้อมูลจำเป็นคำอธิบาย
Authorizationstringจำเป็นBearer ตามด้วย API Secret ของร้านค้า

Query parameters

ฟิลด์ชนิดข้อมูลจำเป็นคำอธิบาย
pagenumberไม่บังคับหน้าที่ต้องการ เริ่มที่ 1 ค่าเริ่มต้นคือ 1
limitnumberไม่บังคับจำนวนรายการต่อหน้า ค่าเริ่มต้นคือ 20 และสูงสุดไม่เกิน 100
status"valid" | "invalid" | "fraud" | "duplicate" | "not_found" | "error"ไม่บังคับกรองเฉพาะรายการที่มีสถานะตามที่ระบุ
transRefstringไม่บังคับค้นหาด้วยเลขอ้างอิงรายการโอนแบบตรงตัว
fromstring (ISO 8601)ไม่บังคับวันเวลาเริ่มต้นของช่วงที่ต้องการ ถ้าอ่านเป็นวันที่ไม่ได้จะได้ HTTP 400
tostring (ISO 8601)ไม่บังคับวันเวลาสิ้นสุดของช่วงที่ต้องการ ถ้าอ่านเป็นวันที่ไม่ได้จะได้ HTTP 400

ตัวอย่างการเรียกใช้

curl -X GET "https://slip.thesurelab.com/api/slip-history?page=1&limit=20&status=valid&from=2026-07-01&to=2026-07-31" \
  -H "Authorization: Bearer $API_SECRET"

ตัวอย่างการเรียก /api/slip-history

ตัวอย่างผลลัพธ์

ตัวอย่างผลลัพธ์
{
  "code": "200001",
  "message": "Get Info Success",
  "data": {
    "items": [
      {
        "code": 200200,
        "status": "valid",
        "amount": 1500,
        "transRef": "0154202607210093A1B2C3D4",
        "transDate": "2026-07-21T09:32:11.000Z",
        "senderName": "นาย ทดสอบ ระบบ",
        "receiverName": "นางสาว ผู้รับ ทดสอบ",
        "receiverAccount": "xxx-x-x9f8e-x",
        "source": "api",
        "tokensCharged": 1,
        "createdAt": "2026-07-21T09:32:12.481Z"
      }
    ],
    "pagination": { "page": 1, "limit": 20, "total": 138, "pages": 7 }
  }
}

อ่านผลจากฟิลด์ code เสมอ

ผลลัพธ์ทางธุรกิจทุกกรณีตอบกลับด้วย HTTP 200 ระบบจะแยกผลด้วยฟิลด์ code เท่านั้น ดูรายการรหัสทั้งหมดได้ที่หน้า Response

ข้อควรรู้

  • รายการเรียงจากใหม่ไปเก่าตาม createdAt เสมอ
  • source บอกช่องทางที่ตรวจ เช่น api, dashboard, line_thesurelab, line_group, line_oa_system, line_oa_merchant, facebook_page