REST API ข้อมูลอ้างอิง
71 ปลายทางทั่วทั้งทรัพยากร 19 SocialHub v2 REST API ช่วยให้คุณจัดการร้านค้า สมาชิกสะสมคะแนน คูปอง แคปเจอร์ โปรแกรม Ambassador และการติดตาม ตำแหน่งข้อมูลทั้งหมดต้องมี Authorization: Bearer fl_live_… เว้นแต่จะระบุไว้
https://flash.socialhub.ai/api/v2ข้อมูลอ้างอิงนี้สะท้อนถึงข้อมูลจริง API เป็นภาพนิ่งของแคตตาล็อกปลายทางที่จัดกลุ่มตามทรัพยากร สำหรับสัญญาที่เครื่องอ่านได้และอัปเดตอยู่เสมอ (พารามิเตอร์ เนื้อหาคำขอ โครงสร้างการตอบกลับ) โปรดดูที่ OpenAPI JSON →
ตรวจสอบสิทธิ์ด้วยคีย์ Bearer
ทุกคำขอจะได้รับการตรวจสอบสิทธิ์ด้วยคีย์ SocialHub API (fl_live_…) ที่ส่งเป็นโทเค็น Bearer คีย์เหล่านี้มีขอบเขตเฉพาะสำหรับทีมของคุณและต่อเครื่องมือ — สร้างและจัดการคีย์เหล่านี้ในบัญชี SocialHub ของคุณ
curl https://flash.socialhub.ai/api/v2/members \
-H "Authorization: Bearer fl_live_your_key_here"ต้องการเก็บคีย์ข้อความธรรมดาออกจากประวัติเชลล์ของคุณหรือไม่? ส่งออกเป็น FLASH_API_KEY และอ้างอิง env var
กำหนดคีย์เป็น คีย์ทดสอบ เพื่อสร้างแอปพลิเคชันในสภาพแวดล้อมจำลอง (sandbox) บน URL เดียวกันนี้ โดยไม่ต้องใช้สภาพแวดล้อมหรือข้อมูลรับรองแยกต่างหาก ข้อมูลที่เขียนด้วยคีย์นี้ (สมาชิก คำสั่งซื้อ คูปอง) จะถูกติดแท็กและซ่อนจากรายการและแดชบอร์ดที่ใช้งานจริงของคุณ สมาชิกทดสอบจะไม่ได้รับการติดต่อจริง ๆ (อีเมลการตลาด SMS และการแจ้งเตือนแบบพุชจะถูกระงับ) และคูปองทดสอบจะไม่สามารถแลกเป็นมูลค่าจริงได้ และการแก้ไข POST /api/v2/test-data/purge เพียงครั้งเดียวจะลบข้อมูลทั้งหมด ทดลองได้อย่างอิสระ แล้วรีเซ็ต
เอนด์พอยต์
ปลายทาง 71 ทั่วทั้งกลุ่มทรัพยากร 19 วิธีการ เส้นทาง และการสรุปหนึ่งบรรทัดสำหรับแต่ละพารามิเตอร์ — พารามิเตอร์แบบเต็มและรายละเอียดสคีมาอาศัยอยู่ใน OpenAPI JSON
CWM การคาดการณ์
4 ปลายทาง sCWMการแจกจ่ายเหตุการณ์ถัดไปครั้งสุดท้ายเพียงครั้งเดียวของ TimesFM 2.5 การคาดการณ์ความต้องการและหน้าต่างการรวมส่วนตัวของผู้เช่า พฤติกรรมถัดไปต้องการ predictions:readแนวโน้ม/หน้าต่างยังต้องการ metrics:readความน่าจะเป็นของเหตุการณ์ถัดไปไม่ได้ถูกปรับเทียบและขึ้นอยู่กับเป้าหมายที่รองรับ หน้าต่างการรวมข้อมูลยังคงอยู่ null จนกว่าจะได้รับการฝึกอบรมและตรวจสอบความถูกต้อง
/api/v2/cwm/capabilities/api/v2/cwm/members/{id}/next-behaviors/api/v2/cwm/trends/api/v2/cwm/members/{id}/purchase-windowsร้านค้า
4 ปลายทาง sการจัดการร้านค้า
/api/v2/stores/api/v2/stores/{id}/api/v2/stores/api/v2/stores/{id}สมาชิก
12 ปลายทาง sการจัดการสมาชิกความภักดี
/api/v2/members/api/v2/members/api/v2/members/batch/api/v2/members/{id}/api/v2/members/{id}/api/v2/members/{id}/points/api/v2/members/{id}/points/api/v2/members/{id}/tier/api/v2/members/{id}/coupons/api/v2/members/{id}/receipts/api/v2/members/{id}/profile/api/v2/members/{id}/redeem-couponคำสั่งซื้อ
4 ปลายทาง sการนำเข้าคำสั่งซื้อ → ให้คะแนนอัตโนมัติ การคืนเงิน และการปรับยอด
/api/v2/orders/api/v2/orders/api/v2/orders/batch/api/v2/orders/{externalOrderId}/refundแคตตาล็อก
5 ปลายทาง sแคตตาล็อกผลิตภัณฑ์ (PIM) — ผลิตภัณฑ์ ตัวเลือก หมวดหมู่ แบรนด์; นำเข้า ERP ทั่วไป/Shopify
/api/v2/products/api/v2/products/{id}/api/v2/categories/api/v2/brands/api/v2/catalog/importฟิลด์ที่กำหนดเอง
2 ปลายทาง sอ่านฟิลด์ที่กำหนดเองโดยผู้เช่าสำหรับเอนทิตีใดๆ (สมาชิก / ร้านค้า / ผลิตภัณฑ์ / กลุ่มคูปอง / คำสั่งซื้อ) อ่านอย่างเดียว ไม่ใช่ข้อมูลส่วนบุคคลตามการออกแบบ ขอบเขต: custom_fields:read
/api/v2/custom-fields/api/v2/custom-fields/valuesจับภาพ
1 ปลายทางบันทึกข้อมูล
/api/v2/capturesคูปอง
4 ปลายทาง sกลุ่มคูปอง รหัส และการแลกของรางวัล
/api/v2/coupons/api/v2/coupons/pools/api/v2/coupons/issue/api/v2/coupons/{id}/redeemเอกอัครราชทูต
3 ปลายทาง sโปรแกรม Ambassador — ผู้สมัคร รายงาน ROI และรหัสพันธมิตร
/api/v2/ambassador/candidates/api/v2/ambassador/metrics/api/v2/ambassador/members/{id}/issue-codeการติดตาม
2 ปลายทาง sการวิเคราะห์การเข้าชมเพจ/พฤติกรรม และการบันทึกเหตุการณ์
/api/v2/tracking/stats/api/v2/tracking/eventsAPI คีย์
3 ปลายทาง sAPI การจัดการคีย์
/api/v2/api-keys/api/v2/api-keys/api/v2/api-keys/{id}การรับรองความถูกต้อง
7 ปลายทาง sการตรวจสอบสิทธิ์และโปรไฟล์ผู้ใช้
/api/v2/auth/register/api/v2/auth/login/api/v2/auth/profile/api/v2/auth/profile/api/v2/auth/change-password/api/v2/auth/forgot-password/api/v2/auth/reset-passwordส่วนต่างๆ
5 ปลายทาง sกลุ่มผู้ชม — เงื่อนไขที่มีโครงสร้างที่ใช้ในการกำหนดเป้าหมายแคมเปญ
/api/v2/segments/api/v2/segments/api/v2/segments/{id}/api/v2/segments/{id}/api/v2/segments/{id}แคมเปญ
3 ปลายทาง sแคมเปญ — แสดงรายการและสร้างแบบร่าง (ไม่ต้องส่ง; ให้มนุษย์ตรวจสอบและส่ง)
/api/v2/campaigns/api/v2/campaigns/api/v2/campaigns/{id}ระบบอัตโนมัติ
2 ปลายทาง sระบบอัตโนมัติ — แสดงรายการโฟลว์ที่กระตุ้นโดยเหตุการณ์และหยุดชั่วคราว/ดำเนินการต่อ
/api/v2/automations/api/v2/automations/{id}การทำธุรกรรม
1 ปลายทางการส่งตามธุรกรรม — ระบบของคุณทริกเกอร์การส่งแคมเปญที่มีผู้รับเพียงรายเดียวซึ่งเปิดใช้งานโดยมนุษย์อย่างชัดเจนสำหรับการใช้งานในธุรกรรม (การยืนยันคำสั่งซื้อ ใบเสร็จรับเงิน) API ไม่เคยเขียนเนื้อหา การปราบปรามการส่งมอบนั้นได้รับเกียรติเสมอ ส่งผ่าน idempotency_key เพื่อให้การลองใหม่ปลอดภัย
/api/v2/transactional/sendการนำเข้า
4 ปลายทาง sการนำเข้าจำนวนมากแบบ Async — อัปโหลดไฟล์สมาชิก CSV/JSONL/คำสั่งซื้อ และสำรวจงาน (ไม่จำกัดแถวสูงสุด 100 แถว)
/api/v2/members/import/api/v2/members/import/{id}/api/v2/orders/import/api/v2/orders/import/{id}ข้อมูลทดสอบ
1 ปลายทางข้อมูลโหมดทดสอบแซนด์บ็อกซ์ — ล้างข้อมูลทุกอย่างที่สร้างคีย์ทดสอบ
/api/v2/test-data/purgeช่องโปรไฟล์การคาดการณ์และคำแนะนำที่ชาญฉลาดยิ่งขึ้น
การอัปเกรดสองครั้งจะเข้าสู่ตำแหน่งข้อมูลที่มีอยู่ — ไม่มีพื้นผิวสาธารณะใหม่และรูปแบบการตอบสนองของตำแหน่งข้อมูลคำแนะนำที่มีอยู่ไม่เปลี่ยนแปลง
GET /api/v2/members/{id}/profileการรวบรวมโปรไฟล์ตอนนี้รวม ฟิลด์การคาดการณ์ ซึ่งคำนวณเมื่อข้อมูลของทีมรองรับ:
- วันที่คาดว่าจะสั่งซื้อครั้งถัดไป — การปรับแบบ Gamma ต่อสมาชิกตามช่วงเวลาการซื้อของสมาชิกเอง (ต้องมีการซื้ออย่างน้อย 3 ครั้ง) โดยจะส่งคืนพร้อมสถิติช่วงเวลาและตัวบ่งชี้ความเชื่อมั่น
- ความน่าจะเป็นในการคลิกอีเมล — โลจิสติกส์ที่ปรับค่า L2 ต่อทีม
P(click)จากคุณสมบัติการมีส่วนร่วมแบบรวมของโปรไฟล์
ทั้งสองฟิลด์ null ต่ำกว่าประตูความซื่อสัตย์ — ไม่ต้องเดาเลย ผู้บริโภคจะต้องจัดการกับค่าว่าง
Recommendations (public embed + v2)การให้คะแนนการซื้อร่วมกันได้รับการอัปเกรดเป็น ความคล้ายคลึงกันระหว่างสินค้าที่ปรับค่าด้วยโคไซน์ ดังนั้นความแข็งแกร่งของคู่สินค้าจึงไม่ถูกครอบงำโดยสินค้าขายดีอีกต่อไป:
score = co_count / sqrt(buyers(A) × buyers(B)) # pairs need ≥2 shared buyers
# raw co_count still storedงานใหม่ทุกคืนจะดำเนินการต่อทีม (การสนับสนุน / ความมั่นใจ / การเพิ่ม MIN_PAIR_ORDERS=3, MIN_CONFIDENCE=0.05, กฎ 25 อันดับแรกต่อรายการก่อนหน้าตามการเพิ่ม) และฟีดคำแนะนำการขายต่อเนื่อง การผสานรวมที่มีอยู่จะยังคงทำงานเหมือนเดิม รูปร่างการตอบสนองไม่เปลี่ยนแปลง