ไล่ดูและค้นหาสินค้า

ฟิลด์นี้มีได้แค่ false (ยืนยันแล้วว่าหมด) กับ null (ยังไม่ได้ตรวจกับต้นทาง) ไม่มีค่า true — ให้ถือว่าเป็นค่าที่ไม่มีอยู่ ไม่ใช่ค่าที่รอให้มันโผล่มา · เอนด์พอยต์แคตตาล็อกตอบจากข้อมูลที่ร้านมีอยู่แล้ว ไม่ได้ไปถามต้นทางทุกครั้งที่เรียก สินค้าส่วนใหญ่จึงกลับมาเป็น null ซึ่งเป็นความจริง คือรอบนี้ไม่มีใครไปตรวจสต็อกของสินค้าชิ้นนั้น · ห้ามเทียบ available === true และห้ามเขียนเงื่อนไขทำนองว่าไม่ใช่ true คือของหมด — อ่านแบบนั้นคือซ่อนแคตตาล็อกเกือบทั้งก้อน ซึ่งเป็นสินค้าที่ขายได้จริง ออกจากหน้าร้านของคุณเอง · ให้ซ่อนเฉพาะชิ้นที่เป็น false · สต็อกจริงถูกตรวจกับต้นทางอีกครั้ง ตอนสั่งซื้อ ซึ่งเป็นจุดเดียวที่คำตอบเรื่องของมีหรือไม่มีเชื่อถือได้

price คือจำนวนบาทที่ คีย์ใบนี้ต้องจ่าย ไม่ใช่ราคาป้ายของร้าน และ discount_percent บอกว่าหักออกจากราคาป้ายไปแล้วกี่เปอร์เซ็นต์ · เอาส่วนลดของคุณไปหักซ้ำอีกรอบจะได้ราคาที่ระบบไม่มีวันยอมรับ แล้วทุกคำสั่งซื้อจะถูกปฏิเสธเรื่องราคาโดยไม่มีอะไรบอกว่าทำไม · ส่วนลดของคุณตั้งไว้เป็นตัวเลขเดียว แต่ สินค้าแต่ละประเภทมีเพดานของตัวเอง ส่วนลดที่ได้จริงคือค่าที่น้อยกว่าระหว่างขั้นส่วนลดของคุณกับเพดานของประเภทนั้น และคุณอ่านค่าที่คิดเสร็จแล้วรายประเภทได้จาก GET /api/v1/me ที่ฟิลด์ discount.effective_percent — อย่าคำนวณราคาฝั่งคุณเองจากเลขส่วนลดดิบ · ราคายังขยับตลอดเวลาทั้งตามราคาขั้นต่ำที่เรารับได้และตามการตั้งราคาของร้านเอง จะเก็บไว้นานแค่ไหนก็ได้ แต่ต้องอ่านราคาใหม่ทุกครั้งก่อนสั่งซื้อ

นอกจากเพดานส่วนลดรายประเภทแล้ว สินค้าแต่ละชิ้นยังมี ราคาขั้นต่ำ ของตัวเองอีกชั้น คือถ้าหักส่วนลดของคุณแล้วราคาจะต่ำกว่าที่เรารับได้ ระบบจะดันราคากลับขึ้นมาที่ขั้นต่ำนั้น (แต่ไม่เกินราคาป้าย) แล้วรายงาน discount_percent เป็นส่วนลดที่คุณได้จริง ซึ่งน้อยกว่าเพดาน · ⚠️ GET /api/v1/products ไม่ได้คิดราคาขั้นต่ำนี้ให้ ราคาที่ได้จากลิสต์จึงเป็นค่าประมาณ และ ต่ำกว่า ราคาจริงที่ระบบยอมรับได้ · ก่อนสั่งซื้อให้อ่านราคาจริงจาก GET /api/v1/products/{product_id} สำหรับ cdkey และ account1 หรือจาก GET /api/v1/products/{product_id}/items สำหรับ account2 แล้วส่งค่านั้นเป็น expected_price · ราคาที่ไม่ตรงกับที่ระบบคำนวณได้ตอนสั่งจะถูก ปฏิเสธ ไม่ใช่ถูกปรับให้เงียบ ๆ

การค้นแบบ ขึ้นต้นด้วย ใช้ตัวชี้ตำแหน่งควบคู่กับการเรียงลำดับด้วยฟิลด์อื่นไม่ได้ การค้นหาจึงไล่หน้าไม่ได้เลย · ส่ง search กับ cursor มาในคำขอเดียวกันจะถูกปฏิเสธด้วย 400 cursor_with_search ไม่ใช่ถูกตอบ ซึ่งตั้งใจ เพราะพฤติกรรมเดิมที่มองข้าม cursor ไปเงียบ ๆ ทำให้ลูป sync วนอยู่กับชุดเดิมไม่รู้จบ โดยไม่มีสถานะ error และไม่มีฟิลด์ไหนบอกว่าเกิดอะไรขึ้น · การค้นหาจึงคืนหน้าเดียว คือทุกอย่างที่แมตช์ ไปจนถึงเพดานที่ search_capped รายงาน · ถ้าชนเพดานนั้น ให้ค้นใหม่ด้วยคำที่ยาวและเจาะจงขึ้น อย่าพยายามเลื่อนหน้าข้ามมันไป · จะ sync ทั้งแคตตาล็อกให้เดิน cursor โดยไม่มี search ทีละ platform

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