파트너 연결 방법
파트너나 회원 관리 시스템마다 지점 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")를 갖춘 자체 시스템을 운영합니다. 이 연결 방법을 사용하면 파트너가 Performance Hub의 시설 ID 대신 자체 식별자로 Performance Hub 시설을 식별할 수 있습니다.
시설 설정: 시설에서 이 파트너를 활성화하면 Performance Hub의 시설 구성에서 파트너가 해당 위치를 식별하는 데 사용하는 고유 식별자를 입력하라는 메시지가 표시됩니다.
API 통합: 파트너가 Performance Hub에 API를 호출할 때 요청에 자체 고유 식별자를 제공할 수 있습니다. Performance Hub는 내부적으로 linking_identifier를 조회하여 API 호출을 올바른 시설과 일치시킵니다.
예시: 파트너가 자체 시스템에서 위치를 "Branch ID"라고 부른다면 아래 레이블을 "Branch ID"로 설정하십시오. 그러면 각 시설이 통합을 활성화할 때 Branch 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"
}
]
}'