คอนโซลพาร์ทเนอร์

Partner Console เป็นอินเทอร์เฟซบนเว็บสำหรับจัดการการผสานรวมของคุณกับ Performance Hub

หากคุณยังไม่มีสิทธิ์เข้าถึง Partner Console โปรดติดต่อเราโดยส่งคำขอเป็นพาร์ทเนอร์ผ่านเว็บไซต์หลักของ Performance Hub ทีมงานของเราจะแนะนำคุณตลอดกระบวนการเริ่มต้นเป็นพาร์ทเนอร์ และช่วยตั้งค่าการเข้าถึงคอนโซลของคุณ

การเข้าถึงคอนโซล

หากต้องการเข้าถึง Partner Console คุณจะต้องมี:

Partner ID - ตัวระบุเฉพาะที่ Performance Hub มอบให้พาร์ทเนอร์แต่ละราย
รหัสผ่านแบบใช้ครั้งเดียว (OTP) - รหัสยืนยันที่ส่งไปยังอีเมลพาร์ทเนอร์ (Partner Email) ของคุณ

เข้าสู่ระบบที่ partner-api.performancehub.co/partner/v1/console

สิ่งที่มีในคอนโซล

Partner Console มีเครื่องมือสำหรับจัดการการผสานรวมของคุณกับ Performance Hub:

Secret Keys - สร้างและจัดการคีย์ API ที่มีระดับการเข้าถึงต่างกัน (live, dryrun, read-only)
Integration Settings - กำหนดค่าวิธีที่การผสานรวมของคุณเชื่อมโยงกับสถานที่
Partner Details - ดูและอัปเดตข้อมูลโปรไฟล์พาร์ทเนอร์ของคุณ
Logs - ติดตามกิจกรรมของ API และแก้ไขปัญหา
Connected Organisations - ดูองค์กรทั้งหมดที่ใช้การผสานรวมของคุณ
Ask AI - รับความช่วยเหลือทันทีด้วยแป้นลัด ⌘I

ดูข้อมูลโดยละเอียดเกี่ยวกับแต่ละฟีเจอร์ได้ที่ฟีเจอร์ของ Partner Console

ฟีเจอร์ของ Partner Console

Partner Console มีส่วนหลักสี่ส่วนที่เข้าถึงได้ผ่านแท็บการนำทาง:

1. คีย์ลับ

จัดการคีย์ลับของ API โดยควบคุมประเภทการเข้าถึงและสิทธิ์ได้อย่างเต็มที่

ฟีเจอร์หลัก:

Create New Keys - สร้างคีย์ API ใหม่ที่มีระดับการเข้าถึงเฉพาะ
Key Types:
- Live - สิทธิ์อ่านและเขียนข้อมูลการใช้งานจริงได้เต็มรูปแบบ
- Dryrun - ทดสอบการดำเนินการเขียนโดยไม่ส่งผลต่อข้อมูลการใช้งานจริง (การเขียนจะเป็นแบบจำลอง)
- Read-only - สิทธิ์อ่านอย่างเดียวเพื่อการใช้ข้อมูลอย่างปลอดภัย (การดำเนินการเขียนจะถูกบล็อก)
Key Management - ดูรายละเอียดคีย์ เวลาที่ใช้งานล่าสุด หมุนเวียนคีย์ และเพิกถอนคีย์ได้ทันที
Key Filtering - กรองคีย์ตามสถานะ (All, Active, Revoked)
Key Rotation - หมุนเวียนคีย์ได้อย่างราบรื่นโดยไม่มีช่วงเวลาหยุดให้บริการ

คีย์ลับแต่ละรายการจะแสดง:

Label - ชื่อที่กำหนดเองได้เพื่อให้ระบุได้ง่าย
Key ID - ตัวระบุเฉพาะ (รูปแบบ UUID)
Secret - คีย์ลับที่ปกปิดไว้บางส่วน (แสดง 12 อักขระแรกและ 4 อักขระสุดท้าย)
Type - ระดับการเข้าถึงของคีย์ (live, dryrun, read-only)
Status - สถานะปัจจุบัน (active, revoked)
Created - วันที่สร้างคีย์
Last Used - เวลาของการเรียก API ครั้งล่าสุด
Actions - หมุนเวียนหรือเพิกถอนคีย์

2. การตั้งค่าการผสานการทำงาน

กำหนดค่าวิธีที่การผสานรวมของคุณเชื่อมโยงกับสถานที่ใน Performance Hub

ฟีเจอร์หลัก:

Data Linking Method - เลือกวิธีการเชื่อมโยงหนึ่งในสองวิธี:
- Direct Link - ใช้ ID สถานที่ของ Performance Hub สำหรับการเรียก API
- Linking Identifier - ใช้ตัวระบุตำแหน่งที่ตั้งของคุณเอง (Branch ID, หมายเลขร้านค้า ฯลฯ)
- ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเชื่อมโยงของพาร์ทเนอร์
Linking Identifier Label - กำหนดชื่อฟิลด์ที่แสดงต่อสถานที่ (เช่น "Branch ID", "Location Code")
Partner Prefix - ตั้งค่าคำนำหน้าเฉพาะสำหรับการผสานรวมของคุณ
Integration Fields - กำหนดค่าฟิลด์แบบกำหนดเองเฉพาะสำหรับการผสานรวมของคุณ

3. รายละเอียดพาร์ทเนอร์

ดูและจัดการข้อมูลโปรไฟล์พาร์ทเนอร์ของคุณ

ฟิลด์ที่แก้ไขได้:

Partner Email - อีเมลติดต่อหลักสำหรับการแจ้งเตือน
Description - คำอธิบายโดยย่อเกี่ยวกับการผสานรวมของคุณ
Logo URL - URL ของโลโก้พาร์ทเนอร์ของคุณ
Website - เว็บไซต์ของบริษัทหรือการผสานรวมของคุณ
Category - การจัดประเภทหมวดหมู่ของการผสานรวม
Details - ข้อมูลเพิ่มเติมของพาร์ทเนอร์

ข้อมูลแบบอ่านอย่างเดียว:

Partner ID (ตัวระบุเฉพาะ)
ชื่อพาร์ทเนอร์
สถานะการผสานรวม
จำนวนองค์กรที่เชื่อมต่อ

4. บันทึกระบบ

ติดตามกิจกรรมของ API และแก้ไขปัญหาการผสานรวม

ข้อมูลที่มีให้:

บันทึกคำขอ API
รหัสสถานะของการตอบกลับ
ข้อความแสดงข้อผิดพลาด
ข้อมูลการประทับเวลา
เพย์โหลดของคำขอ/การตอบกลับ

องค์กรที่เชื่อมต่อแล้ว

ดูองค์กรทั้งหมดที่เปิดใช้การผสานรวมของคุณ การ์ดของแต่ละองค์กรจะแสดง:

ชื่อองค์กร
แบรนด์ที่เกี่ยวข้อง
จำนวนสถานที่ที่ใช้งานอยู่
สถานะการผสานรวม

Ask AI

รับความช่วยเหลือทันทีเกี่ยวกับหัวข้อที่เกี่ยวข้องกับพาร์ทเนอร์โดยใช้ผู้ช่วย AI (แป้นลัด ⌘I)

สิ่งที่สอบถามได้:

การใช้งานและตัวอย่างของปลายทาง API
การยืนยันตัวตนและการจัดการคีย์ลับ
แนวทางปฏิบัติที่ดีที่สุดในการซิงโครไนซ์ข้อมูล
การแก้ไขปัญหาการผสานรวมที่พบบ่อย
ฟีเจอร์และการนำทางของ Partner Console

วิธีการเชื่อมโยงของพาร์ทเนอร์

พาร์ทเนอร์หรือระบบจัดการสมาชิกแต่ละรายจะระบุสถานที่หรือตำแหน่งที่ตั้งแต่ละแห่งด้วย ID ของตนเอง เช่น Branch ID หมายเลขร้านค้า หรือ ID สถานที่ เรามีวิธีระบุตำแหน่งที่ตั้งสองแบบในระหว่างการซิงค์หรือการส่งข้อมูล

1. ลิงก์โดยตรง

เมื่อส่งข้อมูล พาร์ทเนอร์จะใช้ ID สถานที่จากระบบ Performance Hub

ตัวอย่างเช่น สำหรับพาร์ทเนอร์ A ID ภายในของสถานที่แห่งหนึ่งในโตเกียวคือ branch_tokyo แต่เพื่อให้ข้อมูลเป็นมาตรฐานเดียวกันภายในระบบนิเวศของ Performance Hub เราจะกำหนด ID ใหม่ให้กับตำแหน่งที่ตั้งนี้และพาร์ทเนอร์รายนี้ เช่น UUID: 550e8400-e29b-41d4-a716-446655440000

พาร์ทเนอร์ควรใช้ facility_id นี้เมื่อเรียก API ของเราเพื่อส่งข้อมูล

หากต้องการรับ facility_id ที่ถูกต้องสำหรับการเชื่อมโยง (ตามที่วิธี Direct Link กำหนด) พาร์ทเนอร์สามารถเรียกปลายทาง API /partner/v1/facilities ปลายทางนี้จะส่งคืนรายการสถานที่ทั้งหมดที่เปิดใช้การผสานรวมพาร์ทเนอร์ของคุณใน Performance Hub อยู่ในขณะนี้ พร้อมค่า facility_id ที่สอดคล้องกัน

2. ตัวระบุการเชื่อมโยง

พาร์ทเนอร์ดูแลระบบของตนเองซึ่งมีตัวระบุเฉพาะสำหรับแต่ละตำแหน่งที่ตั้ง (เช่น "Branch ID", "Location Code", "Store Number") วิธีการเชื่อมโยงนี้ช่วยให้พาร์ทเนอร์ระบุสถานที่ใน Performance Hub ได้โดยใช้ตัวระบุของตนเองแทน ID สถานที่ของเรา

การตั้งค่าสถานที่: เมื่อสถานที่เปิดใช้พาร์ทเนอร์รายนี้ ระบบจะแจ้งให้สถานที่ระบุตัวระบุเฉพาะที่พาร์ทเนอร์ใช้ระบุตำแหน่งที่ตั้งของตน ในการกำหนดค่าสถานที่ภายใน Performance Hub

การผสานรวม API: เมื่อพาร์ทเนอร์เรียก API ของ Performance Hub พาร์ทเนอร์สามารถระบุตัวระบุเฉพาะของตนเองในคำขอได้ Performance Hub จะค้นหา linking_identifier ภายในระบบเพื่อจับคู่การเรียก API กับสถานที่ที่ถูกต้อง

ตัวอย่าง: หากพาร์ทเนอร์เรียกตำแหน่งที่ตั้งว่า "Branch ID" ในระบบของตน ให้ตั้งค่าป้ายกำกับด้านล่างเป็น "Branch ID" จากนั้นแต่ละสถานที่จะระบุค่า Branch ID ของตนเมื่อเปิดใช้การผสานรวม ทำให้ซิงโครไนซ์ข้อมูลระหว่างระบบได้อย่างราบรื่น

ตัวอย่างการกำหนดค่าจากหน้าจอการผสานรวมของสถานที่ (มุมมองสถานที่หลักของ Performance Hub) ซึ่งแสดงตัวระบุการเชื่อมโยง / ID ภายในจากระบบจัดการสมาชิกที่กำหนดค่าไว้ในหน้าจอการผสานรวมพาร์ทเนอร์

ตัวอย่าง: Direct Link

curl -X POST https://partner-api.performancehub.co/partner/v1/membership-plans \
  -u sk_live_YOUR_PARTNER_SECRET_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "membership_plans": [
      {
        "membership_plan_id": "plan_unlimited_monthly",
        "facility_id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Unlimited Monthly Access",
        "billing_cycle": "monthly",
        "price": 10058,
        "currency": "JPY"
      }
    ]
  }'

ตัวอย่าง: Linking Identifier

curl -X POST https://partner-api.performancehub.co/partner/v1/membership-plans \
  -u sk_live_YOUR_PARTNER_SECRET_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "membership_plans": [
      {
        "membership_plan_id": "plan_unlimited_monthly",
        "linking_identifier": "branch_tokyo",
        "name": "Unlimited Monthly Access",
        "billing_cycle": "monthly",
        "price": 10058,
        "currency": "JPY"
      }
    ]
  }'