Web Service Endpoint


通知履歴の取得


App Store サーバーがあなたのサーバーに送信しようとした通知のリストを取得します。


App Store Server API 1.5+



URL


POST https://api.storekit.itunes.apple.com/inApps/v1/notifications/history


Sandbox URL


POST https://api.storekit-sandbox.itunes.apple.com/inApps/v1/notifications/history


クエリパラメータ


paginationToken
paginationToken		通知履歴記録を最大 20 件取得するために使用するオプションのトークンです。これより多くの記録を取得できるすべての応答には、paginationToken が含まれます。
注: このエンドポイントを初めて呼び出す場合は、このパラメータを省略してください。

HTTP 本体


NotificationHistory
Request		開始日と終了日、およびオプションのクエリ制約を含む要求本文。
Content-Type: application/json

反応コード


200
NotificationHistory
Response		OK
要求は成功した。
Content-Type: application/json
400
(InvalidTransactionId
Error | Pagination
TokenExpiredError | InvalidPaginationToken
Error | InvalidStart
DateError | InvalidEnd
DateError | StartDate
AfterEndDateError | StartDateTooFarInPast
Error | Invalid
NotificationTypeError | MultipleFilters
SuppliedError)		不正な要求です。
無効な要求です。
Content-Type: application/json
401



未承認
承認ヘッダー内の JSON Web トークン (JWT) が無効です。詳細については、API 要求用の JSON Web トークンの生成 を参照してください。
404
(TransactionIdNotFound
Error | AccountNot
FoundError)		見つからない
Content-Type: application/json
429
RateLimitExceededError		要求がレート制限を超えました。
Content-Type: application/json
500
(GeneralInternalError | GeneralInternal
RetryableError)		内部サーバのエラー
サーバーのエラーです。後で再度試して下さい。
Content-Type: application/json


以下で言及


App Store サーバ API の変更履歴


レート制限の識別



議論


このエンドポイントを呼び出すと、指定した期間内に App Store があなたのサーバーの App Store Server Notifications V2 エンドポイントに送信しようとしたバージョン 2 の App Store サーバー通知 のページ区切りリストを取得できます。期間の開始日は過去 180 日以内を選択してください。


NotificationHistoryRequest オブジェクトで notificationType または notificationSubtype を指定することで、要求をさらに絞り込むことができます。また、単一ユーザーの通知履歴を取得するには、transactionId を提供して下さい。応答（NotificationHistoryResponse）には、元の通知の全ての内容が含まれます。


このエンドポイントを呼び出すたびに、最大 20 件の通知履歴記録が返されます。NotificationHistoryResponse の hasMore フィールドが true の場合、応答の paginationToken をあなたの後続の要求で使用して、次の記録セットを取得してください。後続の要求では、同じ NotificationHistoryRequest 本体を使用してください。


このエンドポイントは、製品環境とサンドボックス環境で利用できます。App Store サーバー通知の構成の詳細については、App Store サーバー通知の有効化 および App Store サーバー通知のURLを入力 を参照してください。


注意

アプリ内購入に関連する通知の場合、履歴記録は App Store が最初に通知を送信した時点のアプリ内購入の状態を反映しており、現在の状態を反映していない可能性があります。自動更新サブスクリプションの現在の状態を取得するには、全サブスクリプション状況の取得 エンドポイントを呼び出します。その他のアプリ内購入の型については、取引履歴の取得 v1 エンドポイントを呼び出します。



以下も見よ


App Store サーバ通知履歴


object NotificationHistoryRequest

通知履歴の要求本体。


object NotificationHistoryResponse

署名された通知ペイロードとサーバの最初の送信試行の結果を含む、App Store サーバの通知履歴レコード。


object notificationHistoryResponseItem

署名された通知ペイロードとサーバーの最初の送信試行の結果を含む、App Store サーバーの通知履歴記録。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ