Web サービスエンドポイント

サブスクリプションを Advanced Commerce API に移行する

顧客がアプリ内購入を通じて購入したサブスクリプションを、Advanced Commerce API を使用して管理するサブスクリプションに移行します。

Advanced Commerce API 1.0+

URL

POST https://api.storekit.itunes.apple.com/advancedCommerce/v1/subscription/migrate/{transactionId}

サンドボックス URL

POST https://api.storekit-sandbox.itunes.apple.com/advancedCommerce/v1/subscription/migrate/{transactionId}

パスパラメータ

transactionId
string

(必須)移行すべき自動更新サブスクリプションの取引 ID。サブスクリプションの元の取引 ID、またはサブスクリプションに関連する取引のそれ以降の取引 ID を使用します。

HTTP 本体

SubscriptionMigrate
Request

移行の詳細が含まれる要求本文。
Content-Type: application/json

応答コード

200 SubscriptionMigrate Response	OK 要求は成功しました。 Content-Type: application/json
400 (RepeatedRequest ReferenceIdError \| NullRequestInfoError \| NullTaxCodeError \| NullItemsError \| Null DescriptorsError \| NullSKUError \| Null DisplayNameError \| NullDescriptionError \| InvalidAppAccountToken Error \| NullRequest ReferenceIDError \| InvalidRequest ReferenceIDError \| InvalidConsistency TokenError \| Invalid StorefrontError \| SKULengthExceededError \| DescriptionLength ExceededError \| DisplayNameLength ExceededError \| InvalidDisplayName Error \| Invalid DescriptionError \| InvalidProductError \| InvalidSKUError \| InvalidTaxProductCode Error \| Mismatched StorefrontError \| MissingPricingConfig ForStorefrontError \| OperationNotAllowed Error \| Malformed PayloadError \| AtLeast OneItemError \| Null TargetProductIDError \| InvalidTargetProduct IDError \| Subscription AlreadyMigratedError \| ItemLimitExceededError \| PendingChanges MismatchError)	不正な要求です Content-Type: application/json
401	許可されていません認証ヘッダー内の JSON Web Token (JWT) が無効です。詳細については、あなたのサーバーからの API 要求の承認をご覧ください。
403 (SubscriptionDoesNot ExistError \| SubscriptionAlready ExistsError \| SubscriptionNot EligibleError \| ProductNotOwnedError \| InactiveACASubError \| ProductNotEligible Error \| Storefront ChangeError)	禁止されている Content-Type: application/json
404 (TransactionIdNotFound Error \| ProductNot FoundError)	見つからない Content-Type: application/json
429 RateLimitExceededError	要求がレート制限を超えました。詳細については、Advanced Commerce API のレート制限の特定をご覧ください。 Content-Type: application/json
500 (GeneralInternalError \| GeneralInternal RetryableError)	内部サーバーエラーサーバーエラーです。後で再度試して下さい。 Content-Type: application/json

以下で言及

あなたのサーバーからの API 要求の承認

Advanced Commerce API の変更履歴

Advanced Commerce API のレート制限の特定

議論

注意

Advanced Commerce API と StoreKit のアプリ内購入 API を同じアプリで使用できます。どちらの API も、同じ署名済み JWS 取引と JWS 更新情報を含む App Store のコマースシステムを使用します。アプリ内購入 API を使用して提供する製品については、App Store Connect 内で製品 ID を設定して下さい。Advanced Commerce API を使用して提供する製品については、独自の SKU カタログをホストおよび管理し、実行時に製品の詳細を動的に追加します。