İş Ortağı Konsolu

Partner Console, Performance Hub ile entegrasyonunuzu yönetmeniz için bir web arayüzü sunar.

Henüz Partner Console erişiminiz yoksa lütfen Performance Hub Ana Web Sitesi üzerinden bir iş ortaklığı talebi göndererek bizimle iletişime geçin. Ekibimiz iş ortağı katılım sürecinde size yol gösterecek ve konsol erişiminizi ayarlamanıza yardımcı olacaktır.

Konsola erişim

Partner Console'a erişmek için şunlara ihtiyacınız vardır:

Partner ID - Performance Hub tarafından her iş ortağına verilen benzersiz bir tanımlayıcı
Tek Kullanımlık Parola (OTP) - Partner Email adresinize gönderilen bir doğrulama kodu

partner-api.performancehub.co/partner/v1/console adresinden oturum açın

Konsolda neler var

Partner Console, Performance Hub ile entegrasyonunuzu yönetmeniz için araçlar sunar:

Secret Keys - Farklı erişim düzeylerine (live, dryrun, read-only) sahip API anahtarları oluşturun ve yönetin
Integration Settings - Entegrasyonunuzun tesislere nasıl bağlanacağını yapılandırın
Partner Details - İş ortağı profil bilgilerinizi görüntüleyin ve güncelleyin
Logs - API etkinliğini izleyin ve sorunları giderin
Connected Organisations - Entegrasyonunuzu kullanan tüm organizasyonları görün
Ask AI - ⌘I kısayoluyla anında yardım alın

Her özellik hakkında ayrıntılı bilgi için Partner Console Özellikleri bölümüne bakın.

Partner Console Özellikleri

Partner Console, gezinme sekmelerinden erişilebilen dört ana bölüm içerir:

1. Gizli Anahtarlar

API gizli anahtarlarınızı erişim türleri ve izinler üzerinde tam denetimle yönetin.

Temel özellikler:

Create New Keys - Belirli erişim düzeylerine sahip yeni API anahtarları oluşturun
Anahtar türleri:
- Live - Üretim verilerine tam okuma-yazma erişimi
- Dryrun - Yazma işlemlerini üretim verilerini etkilemeden test edin (yazma işlemleri simüle edilir)
- Read-only - Güvenli veri kullanımı için salt okunur erişim (yazma işlemleri engellenir)
Anahtar yönetimi - Anahtar ayrıntılarını ve son kullanım zaman damgalarını görüntüleyin, anahtarları döndürün ve anında iptal edin
Anahtar filtreleme - Anahtarları duruma göre filtreleyin (All, Active, Revoked)
Anahtar döndürme - Anahtarları kesinti olmadan sorunsuzca döndürün

Her gizli anahtar şunları gösterir:

Label - Kolay tanımlama için özelleştirilebilir ad
Key ID - Benzersiz tanımlayıcı (UUID biçiminde)
Secret - Kısmen gizlenmiş gizli anahtar (ilk 12 ve son 4 karakter görünür)
Type - Anahtar erişim düzeyi (live, dryrun, read-only)
Status - Geçerli durum (active, revoked)
Created - Anahtarın oluşturulduğu tarih
Last Used - En son API çağrısının zaman damgası
Actions - Anahtarı döndürme veya iptal etme

2. Entegrasyon Ayarları

Entegrasyonunuzun Performance Hub tesislerine nasıl bağlanacağını yapılandırın.

Temel özellikler:

Data Linking Method - İki bağlama yöntemi arasından seçim yapın:
- Direct Link - API çağrıları için Performance Hub tesis kimliklerini kullanın
- Linking Identifier - Kendi konum tanımlayıcılarınızı kullanın (Branch ID, Store Number vb.)
- İş Ortağı Bağlama Yöntemleri hakkında daha fazla bilgi edinin
Linking Identifier Label - Tesislere gösterilen alan adını özelleştirin (ör. "Branch ID", "Location Code")
Partner Prefix - Entegrasyonlarınız için benzersiz bir ön ek belirleyin
Integration Fields - Entegrasyonunuza özgü özel alanları yapılandırın

3. İş Ortağı Detayları

İş ortağı profil bilgilerinizi görüntüleyin ve yönetin.

Düzenlenebilir alanlar:

Partner Email - Bildirimler için birincil iletişim e-postası
Description - Entegrasyonunuzun kısa açıklaması
Logo URL - İş ortağı logonuzun URL'si
Website - Şirketinizin veya entegrasyonunuzun web sitesi
Category - Entegrasyon kategorisi sınıflandırması
Details - Ek iş ortağı bilgileri

Salt okunur bilgiler:

Partner ID (benzersiz tanımlayıcı)
İş ortağı adı
Entegrasyon durumu
Bağlı organizasyon sayısı

4. Günlükler

API etkinliğini izleyin ve entegrasyon sorunlarını giderin.

Kullanılabilir veriler:

API istek kayıtları
Yanıt durum kodları
Hata mesajları
Zaman damgası bilgileri
İstek/yanıt yükleri

Bağlı Kuruluşlar

Entegrasyonunuzu etkinleştirmiş tüm organizasyonları görüntüleyin. Her organizasyon kartında şunlar gösterilir:

Organizasyon adı
İlişkili markalar
Etkin tesis sayısı
Entegrasyon durumu

Ask AI

Yapay zeka asistanını (⌘I kısayolu) kullanarak iş ortaklığıyla ilgili konularda anında yardım alın.

Şunları sorabilirsiniz:

API uç noktası kullanımı ve örnekleri
Kimlik doğrulama ve gizli anahtar yönetimi
Veri eşitleme en iyi uygulamaları
Yaygın entegrasyon sorunlarını giderme
Partner Console özellikleri ve gezinme

İş Ortağı Bağlama Yöntemleri

Farklı iş ortakları veya üye yönetim sistemleri, her tesisi ya da konumu şube kimliği, mağaza numarası veya tesis kimliği gibi kendi kimlikleriyle tanımlar. Verilerin eşitlenmesi veya gönderilmesi sırasında konumları tanımlamanın iki yolu vardır.

1. Doğrudan Bağlantı

Veri gönderirken iş ortağı, Performance Hub sistemindeki tesis kimliğini kullanır.

Örneğin, İş Ortağı A'nın Tokyo'daki bir tesis için dahili kimliği branch_tokyo olsun. Ancak verileri Performance Hub ekosisteminde normalleştirmek için bu konum ve bu iş ortağı için yeni bir kimlik atarız; örneğin UUID: 550e8400-e29b-41d4-a716-446655440000.

İş ortakları, veri göndermek için API'lerimizi çağırırken bu facility_id değerini kullanmalıdır.

Bağlama için doğru facility_id değerini almak üzere (Direct Link yönteminde gerektiği gibi) iş ortakları /partner/v1/facilities API uç noktasını çağırabilir. Bu uç nokta, Performance Hub'da iş ortağı entegrasyonunuzun şu anda etkin olduğu tüm tesislerin listesini, karşılık gelen facility_id değerleriyle birlikte döndürür.

2. Bağlantı Tanımlayıcısı

İş ortağı, her konum için benzersiz tanımlayıcılara (ör. "Branch ID", "Location Code", "Store Number") sahip kendi sistemini yönetir. Bu bağlama yöntemi, iş ortağının Performance Hub tesislerini bizim Tesis Kimliğimiz yerine kendi tanımlayıcısıyla tanımlamasını sağlar.

Tesis kurulumu: Bir tesis bu iş ortağını etkinleştirdiğinde, Performance Hub'daki tesis yapılandırmasında iş ortağının konumunu tanımlamak için kullandığı benzersiz tanımlayıcıyı girmesi istenir.

API entegrasyonu: İş ortağı Performance Hub'a API çağrısı yaptığında, istekte kendi benzersiz tanımlayıcısını sağlayabilir. Performance Hub, API çağrısını doğru tesisle eşleştirmek için linking_identifier değerini dahili olarak arar.

Örnek: İş ortağı kendi sisteminde konumlara "Branch ID" diyorsa aşağıdaki etiketi "Branch ID" olarak ayarlayın. Ardından her tesis, entegrasyonu etkinleştirirken kendi Branch ID değerini girer ve böylece sistemler arasında sorunsuz veri eşitlemesi sağlanır.

İş ortağı entegrasyonları ekranında yapılandırılan, üye yönetim sistemindeki bağlama tanımlayıcısını / dahili kimliği gösteren bir Tesis Entegrasyonları Ekranından (Ana Performance Tesis Görünümü) örnek yapılandırma

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

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