POST/v1/customers/apple/link

Apple 고객과 앱 계정 연결

검증한 Apple 구매 신원을 앱 계정에 연결합니다.

인증: Bearer필수 범위: customers:write

요청 본문

signedAppTransaction필수

string

StoreKit AppTransaction JWS 값입니다.

signedTransactions선택

string[]

선택 StoreKit 거래 JWS 목록입니다.

applicationAccountIdentifier필수

string

앱에서 사용하는 안정적인 계정 식별자입니다.

응답

200연결한 고객의 현재 권한입니다.

customerIdentifier필수

string | null · uuid

applicationIdentifier필수

string · uuid

entitlements필수

CustomerEntitlement[]

400요청 값이나 검증한 스토어 데이터가 올바르지 않습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

401애플리케이션 API 자격 증명이 없거나 올바르지 않습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

403애플리케이션 API 자격 증명에 필요한 범위가 없습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

404앱, 스토어 구성, 고객 또는 페이월을 찾지 못했습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

409고객 신원이 기존 검증 신원과 충돌합니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

요청 예시

cURL

curl 'https://api.purpl.sh/v1/customers/apple/link' \
  --header 'Authorization: Bearer <application-api-credential>' \
  --header 'Content-Type: application/json' \
  --data '{
    "signedAppTransaction": "<app-transaction-jws>",
    "signedTransactions": ["<transaction-jws>"],
    "applicationAccountIdentifier": "user-123"
  }'