ดูออเดอร์ล่าสุด

GET/api/v1/orders

สิทธิ์ที่ต้องใช้:orders:read

ดูออเดอร์ล่าสุดของคุณไม่เกิน 100 รายการ เรียงจากใหม่ไปเก่า · เอนด์พอยต์นี้ไม่ใช่ประวัติออเดอร์ทั้งหมด และไม่ควรใช้แทนฐานข้อมูลฝั่งคุณ — ไม่มีตัวกรอง ไม่มีการเลื่อนหน้า และออเดอร์ที่เก่ากว่า 100 รายการล่าสุดจะเข้าถึงผ่านทางนี้ไม่ได้อีกเลย · วิธีที่ถูกคือ เก็บ order_id ของทุกออเดอร์ไว้ฝั่งคุณตั้งแต่ตอนสั่ง แล้วเวลากระทบยอดค่อยอ่านทีละรายการด้วย GET /api/v1/orders/{order_id} · ลิสต์นี้เอาไว้ไล่ดูคร่าว ๆ หรือเอาไว้ตามหาออเดอร์ที่คุณทำ order_id หายไปจริง ๆ

อย่าใช้ลิสต์นี้เป็นฐานข้อมูลออเดอร์ของคุณ

เอนด์พอยต์นี้คืนออเดอร์ล่าสุดไม่เกิน 100 รายการ ไม่มี cursor และไม่มีตัวกรองสักตัว — เลื่อนหน้าไม่ได้ และออเดอร์ที่เก่ากว่านั้นเข้าถึงผ่านทางนี้ไม่ได้อีกเลย · ทุกครั้งที่คุณเรียก เราต้องอ่านประวัติออเดอร์ ทั้งหมด ของบัญชีคุณก่อน แล้วค่อยตัดเหลือ 100 รายการ ต้นทุนของคำขอนี้จึงแพงขึ้นเองทุกวันตามจำนวนออเดอร์ที่คุณสะสมไว้ · การเขียนโปรแกรมวนเรียกลิสต์นี้ถี่ ๆ เพื่อตามสถานะ จึงเป็นวิธีที่แพงและช้าที่สุดสำหรับงานที่ควรอยู่ฝั่งคุณอยู่แล้ว · ให้บันทึก order_id ของทุกออเดอร์ไว้ฝั่งคุณตั้งแต่ตอนสั่ง แล้วตามสถานะด้วย GET /api/v1/orders/{order_id} ทีละรายการ · เก็บลิสต์นี้ไว้ใช้ตอนไล่ดูด้วยตาเอง หรือตอนตามหาออเดอร์ที่ order_id หายไปจริง ๆ

การปฏิเสธที่ด่านยืนยันตัวตนเกิดกับเอนด์พอยต์นี้ด้วย

ห้ารหัสของด่านยืนยันตัวตน — invalid_key (401) · key_revoked (401) · insufficient_scope (403) · quota_exceeded (429) · too_many_inflight (429) — เกิดได้กับทุกเอนด์พอยต์ รวมทั้งเอนด์พอยต์นี้ เพราะถูกโยนตั้งแต่ก่อนคำขอจะเดินไปถึงตรรกะของหน้านี้เลยสักบรรทัด (scope ที่ต้องมีคือค่าที่ประกาศไว้หัวหน้านี้) · แท็บคำตอบด้านบนจึงไล่เฉพาะสิ่งที่เอนด์พอยต์นี้เองตอบ ไม่ได้แปลว่าห้ารหัสนั้นเกิดที่นี่ไม่ได้ · รายละเอียดครบทุกตัวอยู่ที่ หน้าเอนด์พอยต์ตัวตนที่ /developers/access/me ที่เดียว ทั้ง HTTP status ของแต่ละตัว · ตัวไหนกินโควตารายวันบ้าง · header อะไรกลับมาบ้าง · และทำไม 429 สองตัวต้องรับมือคนละแบบ — จงใจไม่คัดลอกมาไว้ทุกหน้า เพราะสำเนาที่สองคือที่ที่ลืมแก้ตามในวันที่กติกาเปลี่ยน

ข้อมูลที่ต้องส่ง

Header

ชื่อ	ชนิด	วิธีใช้
Authorizationบังคับ	string	คีย์ของคุณในรูป `Bearer <คีย์>` — ต้องส่งมาทุกคำขอ · ลิสต์นี้แสดงเฉพาะออเดอร์ของบัญชีที่คีย์นี้ผูกอยู่ ไม่มีทางเห็นออเดอร์ของ reseller คนอื่น

ข้อมูลที่ได้รับ

ชื่อ	ชนิด	วิธีใช้
orders	อาร์เรย์ของอ็อบเจกต์	ออเดอร์เรียงจากใหม่ไปเก่า รายละเอียดและข้อควรระวัง แต่ละรายการมีฟิลด์ครบเหมือนกับที่ `GET /api/v1/orders/{order_id}` คืนให้ออเดอร์ตัวเดียวกันเป๊ะทุกช่อง คือ `order_id` `status` `type` `product_id` `price` `charged` `delivery` `error` `created_at` `updated_at` กติกาสองข้อเดิมใช้ที่นี่ด้วย คือ `delivery` มีสองรูปโดยดูจาก `type` ของออเดอร์นั้น และคำถามว่าจ่ายไปแล้วเท่าไหร่มีคำตอบอยู่ที่ `charged` ที่เดียว คำอธิบายรายฟิลด์อยู่ที่หน้าอ่านออเดอร์รายตัว (`/developers/orders/get`) ไม่มีฟิลด์ไหนบอกว่ายังมีออเดอร์เก่าเหลืออยู่อีกกี่รายการ เพราะเอนด์พอยต์นี้ไม่ได้ออกแบบมาให้ไล่อ่านประวัติทั้งหมด

สถานะที่อาจได้รับ

สถานะ	รหัส	ความหมาย
200	—	มีออเดอร์อยู่ — ได้รายการล่าสุดกลับมา เรียงจากใหม่ไปเก่า · ตัวอย่างนี้ผสมทั้งออเดอร์ที่ยังรอคิว ออเดอร์ที่ส่งมอบแล้ว และออเดอร์ที่จบเป็น `failed` ปนกัน ซึ่งเป็นเรื่องปกติ
200	—	ยังไม่มีออเดอร์ — ได้อาร์เรย์ว่าง ไม่ใช่ 404 บัญชีที่ยังไม่เคยสั่งอะไรเลยจะได้ก้อนนี้ · `orders` เป็นอาร์เรย์ว่าง ไม่ใช่ `null` และไม่ใช่ 404 โค้ดฝั่งคุณจึงวนลูปได้เลยโดยไม่ต้องเช็คก่อน

คำขอ

curl -H "Authorization: Bearer $NAXSET_API_KEY" \
  "https://www.naxset.com/api/v1/orders"

สถานะที่อาจได้รับ

มีออเดอร์อยู่ — ได้รายการล่าสุดกลับมา

200

{
  "orders": [
    {
      "order_id": "ord_89abcdef0123456789abcdef",
      "status": "queued",
      "type": "account2",
      "product_id": "7ab4c2d19e0f5b3a6c8d24ef",
      "price": 690,
      "charged": null,
      "delivery": null,
      "error": null,
      "created_at": "2026-09-07T04:20:00.000Z",
      "updated_at": "2026-09-07T04:20:00.000Z"
    },
    {
      "order_id": "ord_0123456789abcdef01234567",
      "status": "completed",
      "type": "cdkey",
      "product_id": "5f2c1a9e4b7d3c0812ab34cd",
      "price": 430,
      "charged": { "amount": 430, "currency": "THB" },
      "delivery": { "keys": [{ "serial": "AAAAA-BBBBB-CCCCC" }] },
      "error": null,
      "created_at": "2026-09-07T04:15:02.000Z",
      "updated_at": "2026-09-07T04:15:11.000Z"
    },
    {
      "order_id": "ord_1a2b3c4d5e6f708192a3b4c5",
      "status": "failed",
      "type": "account2",
      "product_id": "7ab4c2d19e0f5b3a6c8d24ef",
      "price": 690,
      "charged": null,
      "delivery": null,
      "error": {
        "code": "out_of_stock",
        "message": "Product is currently out of stock."
      },
      "created_at": "2026-09-06T22:02:00.000Z",
      "updated_at": "2026-09-06T22:09:31.000Z"
    }
  ]
}

ยังไม่มีออเดอร์ — ได้อาร์เรย์ว่าง ไม่ใช่ 404

200

{ "orders": [] }

อัปเดตล่าสุด 2026-09-07