Konsol Rakan Kongsi

Partner Console menyediakan antara muka web untuk mengurus integrasi anda dengan Performance Hub.

Jika anda belum mempunyai akses kepada Partner Console, sila hubungi kami dengan menghantar pertanyaan rakan kongsi melalui Laman Web Utama Performance Hub. Pasukan kami akan membimbing anda melalui proses penyertaan rakan kongsi dan membantu menyediakan akses konsol anda.

Mengakses Konsol

Untuk mengakses Partner Console, anda memerlukan:

1. Partner ID - Pengecam unik yang diberikan oleh Performance Hub kepada setiap rakan kongsi
2. One-Time Password (OTP) - Kod pengesahan yang dihantar ke Partner Email anda

Log masuk di partner-api.performancehub.co/partner/v1/console

Kandungan Konsol

Partner Console menyediakan alat untuk mengurus integrasi anda dengan Performance Hub:

• Secret Keys - Jana dan urus kunci API dengan tahap akses yang berbeza (live, dryrun, read-only)
• Integration Settings - Konfigurasikan cara integrasi anda dipautkan dengan kemudahan
• Partner Details - Lihat dan kemas kini maklumat profil rakan kongsi anda
• Logs - Pantau aktiviti API dan selesaikan masalah
• Connected Organisations - Lihat semua organisasi yang menggunakan integrasi anda
• Ask AI - Dapatkan bantuan segera dengan pintasan ⌘I

Untuk maklumat terperinci tentang setiap ciri, lihat Ciri-ciri Partner Console.

Ciri-ciri Partner Console

Partner Console merangkumi empat bahagian utama yang boleh diakses melalui tab navigasi:

1. Kekunci Rahsia

Urus kunci rahsia API anda dengan kawalan penuh ke atas jenis akses dan kebenaran.

Ciri-ciri Utama:

• Create New Keys - Jana kunci API baharu dengan tahap akses tertentu
• Key Types:
  • Live - Akses baca-tulis penuh kepada data pengeluaran
  • Dryrun - Uji operasi tulis tanpa menjejaskan data pengeluaran (operasi tulis disimulasikan)
  • Read-only - Akses baca sahaja untuk penggunaan data yang selamat (operasi tulis disekat)
• Key Management - Lihat butiran kunci dan cap masa terakhir digunakan, putar kunci dan batalkan kunci serta-merta
• Key Filtering - Tapis kunci mengikut status (All, Active, Revoked)
• Key Rotation - Putar kunci dengan lancar tanpa masa henti

Setiap kunci rahsia memaparkan:

• Label - Nama yang boleh disesuaikan untuk pengenalan mudah
• Key ID - Pengecam unik (format UUID)
• Secret - Kunci rahsia yang disunting sebahagiannya (12 aksara pertama dan 4 aksara terakhir kelihatan)
• Type - Tahap akses kunci (live, dryrun, read-only)
• Status - Keadaan semasa (active, revoked)
• Created - Tarikh kunci dijana
• Last Used - Cap masa panggilan API terkini
• Actions - Putar atau batalkan kunci

2. Tetapan Integrasi

Konfigurasikan cara integrasi anda dipautkan dengan kemudahan Performance Hub.

Ciri-ciri Utama:

• Data Linking Method - Pilih antara dua kaedah pemautan:
  • Direct Link - Gunakan ID kemudahan Performance Hub untuk panggilan API
  • Linking Identifier - Gunakan pengecam lokasi anda sendiri (Branch ID, Store Number dan sebagainya)
  • Ketahui lebih lanjut tentang Kaedah Pemautan Rakan Kongsi
• Linking Identifier Label - Sesuaikan nama medan yang dipaparkan kepada kemudahan (contohnya, "Branch ID", "Location Code")
• Partner Prefix - Tetapkan awalan unik untuk integrasi anda
• Integration Fields - Konfigurasikan medan tersuai khusus untuk integrasi anda

3. Butiran Rakan Kongsi

Lihat dan urus maklumat profil rakan kongsi anda.

Medan Boleh Diedit:

• Partner Email - E-mel hubungan utama untuk pemberitahuan
• Description - Penerangan ringkas tentang integrasi anda
• Logo URL - URL ke logo rakan kongsi anda
• Website - Laman web syarikat atau integrasi anda
• Category - Klasifikasi kategori integrasi
• Details - Maklumat tambahan rakan kongsi

Maklumat Baca Sahaja:

• Partner ID (pengecam unik)
• Nama Rakan Kongsi
• Status Integrasi
• Bilangan Organisasi Bersambung

4. Log

Pantau aktiviti API dan selesaikan masalah integrasi.

Data yang Tersedia:

• Log Permintaan API
• Kod Status Respons
• Mesej Ralat
• Maklumat Cap Masa
• Muatan Permintaan/Respons

Organisasi Bersambung

Lihat semua organisasi yang telah mendayakan integrasi anda. Setiap kad organisasi memaparkan:

• Nama Organisasi
• Jenama Berkaitan
• Bilangan Kemudahan Aktif
• Status Integrasi

Ask AI

Dapatkan bantuan segera tentang topik berkaitan rakan kongsi menggunakan pembantu AI (pintasan ⌘I).

Tanya Tentang:

• Penggunaan titik akhir API dan contoh
• Pengesahan dan pengurusan kunci rahsia
• Amalan terbaik penyegerakan data
• Menyelesaikan masalah integrasi yang biasa
• Ciri dan navigasi Partner Console

Kaedah Pemautan Rakan Kongsi

Rakan kongsi atau sistem pengurusan ahli yang berbeza mengenal pasti setiap kemudahan atau lokasi dengan ID mereka sendiri, seperti ID cawangan, nombor kedai atau ID kemudahan. Kami mempunyai dua cara untuk mengenal pasti lokasi semasa penyegerakan atau penolakan data.

1. Pautan Terus

Semasa menolak data, rakan kongsi akan menggunakan ID kemudahan daripada sistem Performance Hub.

Contohnya, bagi Rakan Kongsi A, ID dalaman mereka untuk kemudahan di Tokyo ialah branch_tokyo. Tetapi untuk menormalkan data dalam ekosistem Performance Hub, kami memberikan ID baharu untuk lokasi ini dan rakan kongsi ini, contohnya UUID: 550e8400-e29b-41d4-a716-446655440000.

Rakan kongsi hendaklah menggunakan facility_id ini apabila memanggil API kami untuk menolak data.

Untuk mendapatkan facility_id yang betul untuk pemautan (seperti yang diperlukan dalam kaedah Direct Link), rakan kongsi boleh memanggil titik akhir API /partner/v1/facilities. Titik akhir ini akan mengembalikan senarai semua kemudahan yang kini mendayakan integrasi rakan kongsi anda dalam Performance Hub, bersama nilai facility_id masing-masing.

2. Pengecam Pautan

Rakan kongsi menyelenggara sistem mereka sendiri dengan pengecam unik untuk setiap lokasi (contohnya, "Branch ID", "Location Code", "Store Number"). Kaedah pemautan ini membolehkan rakan kongsi mengenal pasti kemudahan Performance Hub menggunakan pengecam mereka sendiri dan bukannya ID Kemudahan kami.

Persediaan Kemudahan: Apabila sesebuah kemudahan mendayakan rakan kongsi ini, mereka akan diminta memberikan pengecam unik yang digunakan oleh rakan kongsi untuk mengenal pasti lokasi mereka dalam konfigurasi kemudahan mereka di Performance Hub.

Integrasi API: Apabila rakan kongsi membuat panggilan API kepada Performance Hub, mereka boleh memberikan pengecam unik mereka sendiri dalam permintaan. Performance Hub akan mencari linking_identifier secara dalaman untuk memadankan panggilan API dengan kemudahan yang betul.

Contoh: Jika rakan kongsi memanggil lokasi sebagai "Branch ID" dalam sistem mereka, tetapkan label di bawah kepada "Branch ID". Setiap kemudahan kemudiannya akan memberikan nilai Branch ID mereka semasa mendayakan integrasi, membolehkan penyegerakan data yang lancar antara sistem.

Contoh konfigurasi daripada Skrin Integrasi Kemudahan (Paparan Kemudahan Performance Utama) yang menunjukkan pengecam pemautan / ID dalaman daripada sistem pengurusan ahli yang dikonfigurasikan dalam skrin integrasi rakan kongsi

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"
      }
    ]
  }'

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"
      }
    ]
  }'