เริ่มต้นใช้งาน

ถ้าคุณอยากเชื่อม DataGlass เข้ากับสคริปต์, โน้ตบุ๊ก หรือ agent ของคุณเอง — แทนที่จะใช้ connector แบบคลิกเดียวอย่าง ChatGPT หรือ Claude — คุณสามารถออก API key แล้วเรียกใช้ DataGlass REST API ได้โดยตรง API key (หรือที่เรียกว่า Personal Access Token) จะมีสิทธิ์เข้าถึงเท่ากับบัญชีของคุณ แต่เป็นแบบ อ่านอย่างเดียว

สร้างคีย์

1. เปิดเมนูบัญชี (มุมขวาบน) แล้วไปที่ Settings → API keys
2. คลิก Create API key
3. ตั้ง ป้ายชื่อ (label) ที่คุณจะจำได้ภายหลัง (เช่น "สคริปต์ดูกำไร" หรือ "Claude Desktop") และเลือก วันหมดอายุ ได้ตามต้องการ — ไม่มีวันหมดอายุ, 30, 60, 90 หรือ 365 วัน
4. คัดลอกโทเคนที่ปรากฏขึ้นมา โทเคนจะขึ้นต้นด้วย dg_pat_

เรียกใช้ API

ส่งโทเคนเป็น Bearer token บน header Authorization โดย API อยู่ที่ https://prod-api.dataglasslabs.com

# แสดงรายการร้าน Shopee ที่เชื่อมต่อ
curl https://prod-api.dataglasslabs.com/api/shopee/fetch-all-user-shops \
  -H "Authorization: Bearer dg_pat_your_token_here"

endpoint ส่วนใหญ่เป็น POST และรับ JSON body — ให้ส่ง Content-Type: application/json:

# ค้นหาสินค้าด้วยข้อความอิสระ
curl -X POST https://prod-api.dataglasslabs.com/api/canonical-product-controller/canonical/search-products \
  -H "Authorization: Bearer dg_pat_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ "query": "phone case" }'

ทุกคำขอจะทำงานในนามของคุณ — เห็นเฉพาะร้าน, สินค้า, ออเดอร์ และรายงานที่บัญชีของคุณเห็นได้เท่านั้น และไม่เห็นข้อมูลของคนอื่นเลย

สิ่งที่เข้าถึงได้

API key เรียกใช้ฝั่ง อ่านข้อมูล ของ DataGlass ได้: สินค้าและแคตตาล็อกรวม, ออเดอร์, การแยกรายละเอียดทางการเงิน, True ROAS, สต๊อก และคำแนะนำชุดเดียวกับที่ขับเคลื่อน Actions ของคุณ คีย์ที่สร้างจากหน้านี้ไม่มีตัวเลือกสิทธิ์ จึงเป็น อ่านอย่างเดียวโดยโครงสร้าง ส่วน connector ChatGPT และ Claude อ่านข้อมูลชุดเดียวกัน แต่ผู้ช่วย AI สามารถขอสิทธิ์เขียนเฉพาะด้านเพิ่มได้ โดยคุณเป็นคนอนุมัติตอนเชื่อมต่อ — ดู สิทธิ์และความปลอดภัย

เอกสารชุดนี้จัดกลุ่ม endpoint เดียวกันออกเป็น 4 หน้าอ้างอิง:

• สินค้าและออเดอร์ — แคตตาล็อก, สินค้ารวม, ออเดอร์, สต๊อก และร้านที่เชื่อมต่อ
• การแยกรายละเอียดทางการเงิน — การแยกกำไรจริง, profit-adjusted ROAS, เครื่องมือมาร์จิน และภาพรวมร้าน
• ข้อมูลแพลตฟอร์มดิบ — ข้อมูลสินค้า, ออเดอร์ และแคมเปญโฆษณาที่ปรับให้เป็นมาตรฐานในแต่ละแพลตฟอร์ม
• Actions และคำแนะนำ — Actions ที่ช่วยเพิ่มกำไรซึ่งระบบสร้างขึ้น

หลักการทั่วไป

สิ่งที่ใช้กับทุก endpoint:

• Base URL — https://prod-api.dataglasslabs.com ทุกพาธในเอกสารต่อจาก URL นี้
• การยืนยันตัวตน — ส่งคีย์เป็น Authorization: Bearer dg_pat_… ในทุกคำขอ
• โครงห่อผลลัพธ์ — ผลลัพธ์ถูกห่อเป็น { "status": "SUCCESS", "statusCode": 200, "message": …, "data": <result> } ชนิดใน Response ของแต่ละ endpoint คือรูปร่างของ data
• วันที่ — ฟิลด์ชนิดวันที่ที่มีเวลาด้วยจะถูกแปลงเป็นอาเรย์: [ปี, เดือน (เริ่มที่ 1), วัน, ชั่วโมง, นาที, วินาที]
• region — รหัสภูมิภาค (เช่น TH) ส่วน shopId / sellerId — ตัวระบุที่ได้จาก endpoint หมวด ร้านค้า ใน สินค้าและออเดอร์
• การแบ่งหน้า — แบบ cursor คืน { rows/data, nextCursor } ให้ส่ง nextCursor กลับเพื่อดึงหน้าถัดไป แบบ offset (v3) รับ page (เริ่มที่ 0) + pageSize และคืน totalItems / totalPages
• ขีดจำกัดการเรียก — 60 คำขอต่อนาทีต่อคีย์ ดู ความปลอดภัยและขีดจำกัดของ API

จัดการและยกเลิกคีย์

ที่หน้า Settings → API keys คุณจะเห็นคีย์ทุกตัวพร้อมป้ายชื่อ, ส่วนนำหน้า (prefix), วันที่ใช้ล่าสุด, วันหมดอายุ และสถานะ คลิก Revoke ที่คีย์ใดก็ได้เพื่อปิดการใช้งาน ทันทีและถาวร — ควรทำทันทีที่สงสัยว่าโทเคนอาจรั่วไหล