POST/v1/customers/apple/synchronize

Apple 구매 동기화

AppTransaction JWS와 거래 JWS를 검증하고 현재 권한을 반환합니다.

인증: 없음

요청 본문

signedAppTransaction필수

string

StoreKit AppTransaction JWS 값입니다.

signedTransactions선택

string[]

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

applicationAccountIdentifier선택

string | null

앱에서 사용하는 선택 계정 식별자입니다.

응답

200동기화한 고객의 현재 권한입니다.

customerIdentifier필수

string | null · uuid

고객을 확인한 경우 반환하는 Purpl 고객 식별자입니다.

entitlements필수

CustomerEntitlement[]

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

error필수

string

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

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

error필수

string

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

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

error필수

string

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

요청 예시

cURL

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