合作伙伴关联方式

不同的合作伙伴或会员管理系统会使用各自的 ID 来标识每个设施或位置，例如分店 ID、门店编号或设施 ID。在同步或推送数据时，我们提供两种标识位置的方式。

1. 直接链接

推送数据时，合作伙伴使用 Performance Hub 系统中的设施 ID。

例如，合作伙伴 A 为东京某个设施使用的内部 ID 是 branch_tokyo。但为了在 Performance Hub 生态系统中对数据进行规范化，我们会为该位置和该合作伙伴分配一个新 ID，例如 UUID：550e8400-e29b-41d4-a716-446655440000。

合作伙伴在调用我们的 API 推送数据时，应使用此 facility_id。

要获取用于关联的正确 facility_id（Direct Link 方式所需），合作伙伴可以调用 /partner/v1/facilities API 端点。该端点将返回当前在 Performance Hub 中启用了您的合作伙伴集成的所有设施列表，以及对应的 facility_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"
      }
    ]
  }'

2. 链接标识符

合作伙伴维护自己的系统，并为每个位置使用唯一标识符（例如“Branch ID”“Location Code”“Store Number”）。通过这种关联方式，合作伙伴可以使用自己的标识符而不是我们的设施 ID 来标识 Performance Hub 设施。

**设施设置：**设施启用该合作伙伴时，系统会提示其在 Performance Hub 的设施配置中提供该合作伙伴用于标识其位置的唯一标识符。

**API 集成：**合作伙伴调用 Performance Hub API 时，可以在请求中提供自己的唯一标识符。Performance Hub 会在内部查找 linking_identifier，将 API 调用匹配到正确的设施。

**示例：**如果合作伙伴在其系统中将位置称为“Branch ID”，请将下方的标签设置为“Branch ID”。之后，每个设施在启用集成时都会提供其 Branch ID 值，从而实现系统之间的无缝数据同步。

设施集成屏幕（Performance 主设施视图）中的示例配置，显示在合作伙伴集成屏幕中配置的来自会员管理系统的关联标识符/内部 ID

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