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.

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

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

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