From 4c16b2997d4843234e441778da179a48f7e950b4 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:45:47 +0100 Subject: [PATCH 01/17] general --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index e97ffd12..e7bac31a 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -13,6 +13,8 @@ public enum APIError { /** * An error that indicates an invalid request. * + * This general error occurs for various reasons, suggesting the request to the server is malformed. + * * @see GeneralBadRequestError */ GENERAL_BAD_REQUEST(4000000L), From 9b334c1b809e07d6c9cc554d24d77b4875faac01 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:48:26 +0100 Subject: [PATCH 02/17] invalid app --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index e7bac31a..9e7bf41a 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -22,6 +22,8 @@ public enum APIError { /** * An error that indicates an invalid app identifier. * + * This error occurs when the provided app identifier does not match any existing app in the App Store's records, often due to a typo or incorrect app ID being used in the request. + * * @see InvalidAppIdentifierError */ INVALID_APP_IDENTIFIER(4000002L), From d4e3de3a2003242bf07f02b9e4a280f80db595b6 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:48:55 +0100 Subject: [PATCH 03/17] invalid request revision --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 9e7bf41a..e3a06916 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -31,6 +31,8 @@ public enum APIError { /** * An error that indicates an invalid request revision. * + * This error signifies that the revision number or identifier provided in the request does not match any known revision, suggesting a potential error in specifying the revision details. + * * @see InvalidRequestRevisionError */ INVALID_REQUEST_REVISION(4000005L), From 838ca06b61dc519d5805608324cc7328339a1e7d Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:49:50 +0100 Subject: [PATCH 04/17] invalid transactionID --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index e3a06916..7a3fa548 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -38,7 +38,9 @@ public enum APIError { INVALID_REQUEST_REVISION(4000005L), /** - * An error that indicates an invalid transaction identifier. + * An error indicating the provided transaction identifier is invalid. + * + * This error occurs when the transaction ID sent in the request cannot be found or does not match any existing transactions in the system, possibly due to a typo or outdated information. * * @see InvalidTransactionIdError */ From 56a315a1949ab7483f077acd6f3cb33d94a736c6 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:50:09 +0100 Subject: [PATCH 05/17] invalid original transactionID --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 7a3fa548..2c6b736d 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -47,7 +47,9 @@ public enum APIError { INVALID_TRANSACTION_ID(4000006L), /** - * An error that indicates an invalid original transaction identifier. + * An error indicating the original transaction identifier is invalid. + * + * This occurs when referencing a transaction that does not exist or the original transaction ID is incorrect, often during attempts to verify or modify a transaction's status. * * @see InvalidOriginalTransactionIdError */ From 229dc11db22663af85b053c9494a02a14d765327 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:50:36 +0100 Subject: [PATCH 06/17] invalid extended by days --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 2c6b736d..2b87535f 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -56,7 +56,9 @@ public enum APIError { INVALID_ORIGINAL_TRANSACTION_ID(4000008L), /** - * An error that indicates an invalid extend-by-days value. + * An error indicating the 'extend-by-days' value provided is invalid. + * + * This error highlights issues with the number of days specified for extending a subscription or trial, usually because the value is out of the accepted range or format. * * @see InvalidExtendByDaysError */ From 9ad2d3b1ac3935cb4420e4aa275bcb8112e7f0bf Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:50:55 +0100 Subject: [PATCH 07/17] invalid extended reason code --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 2b87535f..f28b160d 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -65,7 +65,9 @@ public enum APIError { INVALID_EXTEND_BY_DAYS(4000009L), /** - * An error that indicates an invalid reason code. + * An error indicating the reason code for an extension is invalid. + * + * This error suggests that the provided reason code for requesting an extension, such as for a subscription renewal, does not match any of the known or valid reason codes. * * @see InvalidExtendReasonCodeError */ From 10cc7ba4887f305f738a8cc774529b2e9595cf9a Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:51:45 +0100 Subject: [PATCH 08/17] invalid request identifier --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index f28b160d..7f728e4c 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -74,12 +74,15 @@ public enum APIError { INVALID_EXTEND_REASON_CODE(4000010L), /** - * An error that indicates an invalid request identifier. + * An error indicating the provided request identifier is invalid. + * + * This error occurs when the specified request ID does not match any known or pending requests, possibly due to a mistyped or outdated identifier. * * @see InvalidRequestIdentifierError */ INVALID_REQUEST_IDENTIFIER(4000011L), + /** * An error that indicates that the start date is earlier than the earliest allowed date. * From e6216d24ebc222f310619ec0c5b5dff2ffcd17fd Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:52:11 +0100 Subject: [PATCH 09/17] start date to far in past --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 7f728e4c..fcba4a42 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -82,9 +82,10 @@ public enum APIError { */ INVALID_REQUEST_IDENTIFIER(4000011L), - /** - * An error that indicates that the start date is earlier than the earliest allowed date. + * An error indicating the specified start date is earlier than allowed. + * + * This occurs when a request includes a start date that falls before the earliest date permitted by the App Store's policies or the specific API's operational parameters. * * @see StartDateTooFarInPastError */ From f91b0eca19297a04837555aa1d88db33dc067cf8 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:52:28 +0100 Subject: [PATCH 10/17] start date after end date --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index fcba4a42..3fe45589 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -92,7 +92,9 @@ public enum APIError { START_DATE_TOO_FAR_IN_PAST(4000012L), /** - * An error that indicates that the end date precedes the start date, or the two dates are equal. + * An error indicating the end date is set before the start date or the same as the start date. + * + * This error highlights logical inconsistencies in date ranges provided in requests, such as for subscription periods or event scheduling, which are not permitted. * * @see StartDateAfterEndDateError */ From 706e0abc4aac0f8d193c7cd9a9687c4e84cdbee7 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:52:56 +0100 Subject: [PATCH 11/17] invalid pagination token --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 3fe45589..e26e78ce 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -101,7 +101,9 @@ public enum APIError { START_DATE_AFTER_END_DATE(4000013L), /** - * An error that indicates the pagination token is invalid. + * An error indicating the pagination token used in the request is invalid. + * + * This error typically occurs when navigating through a list of items provided by the API and the supplied token for fetching the next set of results is malformed or expired. * * @see InvalidPaginationTokenError */ From b280fa8f4fe6035de01bc530f3f5e64fedd796be Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:54:51 +0100 Subject: [PATCH 12/17] multiple --- .../itunes/storekit/client/APIError.java | 28 ++++++++++++++----- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index e26e78ce..ff1fe731 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -110,49 +110,63 @@ public enum APIError { INVALID_PAGINATION_TOKEN(4000014L), /** - * An error that indicates the start date is invalid. + * An error indicating the provided start date does not meet validation criteria. + * + * This may occur if the date format is incorrect, or the date is outside an acceptable range for the operation being performed. * * @see InvalidStartDateError */ INVALID_START_DATE(4000015L), /** - * An error that indicates the end date is invalid. + * An error indicating the provided end date does not meet validation criteria. + * + * Similar to the start date error, this can happen if the date is improperly formatted or not within an expected range. * * @see InvalidEndDateError */ INVALID_END_DATE(4000016L), /** - * An error that indicates the pagination token expired. + * An error indicating the pagination token used in the request has expired. + * + * Pagination tokens are typically time-sensitive. This error occurs if a token is used beyond its valid lifespan. * * @see PaginationTokenExpiredError */ PAGINATION_TOKEN_EXPIRED(4000017L), /** - * An error that indicates the notification type or subtype is invalid. + * An error indicating the notification type or subtype specified in the request is not recognized. + * + * This error suggests a mismatch between the provided notification type/subtype and those defined by the API. * * @see InvalidNotificationTypeError */ INVALID_NOTIFICATION_TYPE(4000018L), /** - * An error that indicates the request is invalid because it has too many constraints applied. + * An error indicating that the request cannot be processed due to multiple conflicting filters. + * + * This occurs when a request includes multiple filters that cannot be applied together or are mutually exclusive. * * @see MultipleFiltersSuppliedError */ MULTIPLE_FILTERS_SUPPLIED(4000019L), /** - * An error that indicates the test notification token is invalid. + * An error indicating the test notification token provided is invalid. + * + * This error can arise if the token format is incorrect or the token does not match any known valid tokens. * * @see InvalidTestNotificationTokenError */ INVALID_TEST_NOTIFICATION_TOKEN(4000020L), /** - * An error that indicates an invalid sort parameter. + * An error indicating the sort parameter provided in the request is invalid. + * + * This error is triggered if the sort parameter does not match any of the allowed sorting criteria for the API endpoint. * * @see InvalidSortError */ From db97027b2f9419eae403f52ebf09f4d2ce83536b Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 00:56:57 +0100 Subject: [PATCH 13/17] multiple --- .../apple/itunes/storekit/client/APIError.java | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index ff1fe731..172bc0af 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -175,6 +175,8 @@ public enum APIError { /** * An error that indicates an invalid product type parameter. * + * This error occurs when the product type provided does not match any known product types, potentially due to incorrect data entry. + * * @see InvalidProductTypeError */ INVALID_PRODUCT_TYPE(4000022L), @@ -182,6 +184,8 @@ public enum APIError { /** * An error that indicates the product ID parameter is invalid. * + * This error signifies that the provided product ID does not exist or is incorrectly formatted, indicating a possible error in data entry or retrieval. + * * @see InvalidProductIdError */ INVALID_PRODUCT_ID(4000023L), @@ -189,6 +193,8 @@ public enum APIError { /** * An error that indicates an invalid subscription group identifier. * + * This error arises when the subscription group identifier provided does not correspond to any existing subscription groups, suggesting an error in specifying the identifier. + * * @see InvalidSubscriptionGroupIdentifierError */ INVALID_SUBSCRIPTION_GROUP_IDENTIFIER(4000024L), @@ -196,14 +202,18 @@ public enum APIError { /** * An error that indicates the query parameter exclude-revoked is invalid. * + * This deprecated error occurs if the exclude-revoked parameter was not correctly specified, suggesting a format or logical error. + * + * @deprecated * @see InvalidExcludeRevokedError */ - @Deprecated INVALID_EXCLUDE_REVOKED(4000025L), /** * An error that indicates an invalid in-app ownership type parameter. * + * Triggered when the in-app ownership type specified does not align with valid ownership types, potentially due to incorrect data provision. + * * @see InvalidInAppOwnershipTypeError */ INVALID_IN_APP_OWNERSHIP_TYPE(4000026L), @@ -211,6 +221,8 @@ public enum APIError { /** * An error that indicates a required storefront country code is empty. * + * This error occurs when the storefront country code, a necessary parameter for some requests, is not provided, indicating a missing value. + * * @see InvalidEmptyStorefrontCountryCodeListError */ INVALID_EMPTY_STOREFRONT_COUNTRY_CODE_LIST(4000027L), @@ -218,6 +230,8 @@ public enum APIError { /** * An error that indicates a storefront code is invalid. * + * Occurs when the storefront country code provided does not match any known codes, suggesting an error in specifying the code. + * * @see InvalidStorefrontCountryCodeError */ INVALID_STOREFRONT_COUNTRY_CODE(4000028L), @@ -225,6 +239,8 @@ public enum APIError { /** * An error that indicates the revoked parameter contains an invalid value. * + * This error signifies that the value provided for the revoked parameter is not recognized, possibly due to incorrect formatting or values. + * * @see InvalidRevokedError */ INVALID_REVOKED(4000030L), From e95cad54e9232e2453413e2e66ca317010e55d8a Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 01:02:07 +0100 Subject: [PATCH 14/17] status --- .../itunes/storekit/client/APIError.java | 48 ++++++++++++++----- 1 file changed, 36 insertions(+), 12 deletions(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 172bc0af..5f9b2007 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -246,84 +246,108 @@ public enum APIError { INVALID_REVOKED(4000030L), /** - * An error that indicates the status parameter is invalid. + * An error indicating the status parameter is invalid. + * + * Occurs when the status value provided in the request does not match any of the expected status values defined by the API. * * @see InvalidStatusError */ INVALID_STATUS(4000031L), /** - * An error that indicates the value of the account tenure field is invalid. + * An error indicating the account tenure value is invalid. + * + * This error can happen if the specified value for the account tenure does not conform to the expected format or range. * * @see InvalidAccountTenureError */ INVALID_ACCOUNT_TENURE(4000032L), /** - * An error that indicates the value of the app account token field is invalid. + * An error indicating the app account token is invalid. + * + * This error occurs when the token provided does not match the format or has expired, suggesting an issue in token generation or provision. * * @see InvalidAppAccountTokenError */ INVALID_APP_ACCOUNT_TOKEN(4000033L), /** - * An error that indicates the value of the consumption status field is invalid. + * An error indicating the consumption status value is invalid. + * + * Triggered when the consumption status provided is not recognized, possibly due to incorrect data entry or misunderstanding of valid values. * * @see InvalidConsumptionStatusError */ INVALID_CONSUMPTION_STATUS(4000034L), /** - * An error that indicates the customer consented field is invalid or doesn’t indicate that the customer consented. + * An error indicating the customer consented field is invalid. + * + * Occurs when the provided value does not clearly indicate customer consent, or the format is not as expected by the API. * * @see InvalidCustomerConsentedError */ INVALID_CUSTOMER_CONSENTED(4000035L), /** - * An error that indicates the value in the delivery status field is invalid. + * An error indicating the delivery status is invalid. + * + * This error highlights issues with the specified delivery status, either due to incorrect formatting or invalid status values. * * @see InvalidDeliveryStatusError */ INVALID_DELIVERY_STATUS(4000036L), /** - * An error that indicates the value in the lifetime dollars purchased field is invalid. + * An error indicating the lifetime dollars purchased value is invalid. + * + * Triggered when the amount specified does not align with expected values, possibly indicating a data entry error. * * @see InvalidLifetimeDollarsPurchasedError */ INVALID_LIFETIME_DOLLARS_PURCHASED(4000037L), /** - * An error that indicates the value in the lifetime dollars refunded field is invalid. + * An error indicating the lifetime dollars refunded value is invalid. + * + * Occurs when the specified refunded amount is outside expected ranges, suggesting an error in value provision. * * @see InvalidLifetimeDollarsRefundedError */ INVALID_LIFETIME_DOLLARS_REFUNDED(4000038L), /** - * An error that indicates the value in the platform field is invalid. + * An error indicating the platform specified is invalid. + * + * This error is encountered when the platform identifier provided does not match any known platforms within the App Store ecosystem. * * @see InvalidPlatformError */ INVALID_PLATFORM(4000039L), /** - * An error that indicates the value in the playtime field is invalid. + * An error indicating the playtime value is invalid. + * + * Triggered when playtime data provided does not adhere to the expected format or is outside allowable ranges. * * @see InvalidPlayTimeError */ INVALID_PLAY_TIME(4000040L), /** - * An error that indicates the value in the sample content provided field is invalid. + * An error indicating the sample content provided is invalid. + * + * Occurs when content samples submitted do not meet criteria set by the App Store, potentially due to format or content guidelines. * * @see InvalidSampleContentProvidedError */ INVALID_SAMPLE_CONTENT_PROVIDED(4000041L), /** - * An error that indicates the value in the user status field is invalid. + * An error indicating the user status value is invalid. + * + * This error suggests that the user status provided in the request is not recognized or outside the expected values. * * @see InvalidUserStatusError */ From 5fb2c11f0abd51a641d7b4938348c0ca3aab14c4 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 01:03:34 +0100 Subject: [PATCH 15/17] multiple --- .../itunes/storekit/client/APIError.java | 56 ++++++++++++++----- 1 file changed, 42 insertions(+), 14 deletions(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index 5f9b2007..add5c32d 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -354,98 +354,126 @@ public enum APIError { INVALID_USER_STATUS(4000042L), /** - * An error that indicates the transaction identifier doesn’t represent a consumable in-app purchase. + * An error indicating the transaction identifier doesn't represent a consumable in-app purchase. + * + * This error occurs when an attempt is made to perform an operation that is specific to consumable products on a transaction identifier associated with non-consumable products. * * @see InvalidTransactionNotConsumableError */ INVALID_TRANSACTION_NOT_CONSUMABLE(4000043L), /** - * An error that indicates the subscription doesn't qualify for a renewal-date extension due to its subscription state. + * An error indicating the subscription doesn't qualify for a renewal-date extension due to its subscription state. + * + * This error is returned when a request for a subscription renewal-date extension is made under circumstances where the subscription's current state does not allow for such an extension. * * @see SubscriptionExtensionIneligibleError */ SUBSCRIPTION_EXTENSION_INELIGIBLE(4030004L), /** - * An error that indicates the subscription doesn’t qualify for a renewal-date extension because it has already received the maximum extensions. + * An error indicating the subscription has already received the maximum number of renewal-date extensions. + * + * Occurs when an attempt is made to extend the renewal date of a subscription that has already reached the limit of allowable extensions. * * @see SubscriptionMaxExtensionError */ SUBSCRIPTION_MAX_EXTENSION(4030005L), /** - * An error that indicates a subscription isn't directly eligible for a renewal date extension because the user obtained it through Family Sharing. + * An error indicating a subscription isn't directly eligible for a renewal date extension because it was obtained through Family Sharing. + * + * This error is returned when a renewal date extension is requested for a subscription that was not directly purchased by the user but rather shared through Family Sharing. * * @see FamilySharedSubscriptionExtensionIneligibleError */ FAMILY_SHARED_SUBSCRIPTION_EXTENSION_INELIGIBLE(4030007L), /** - * An error that indicates the App Store account wasn’t found. + * An error indicating the App Store account wasn’t found. + * + * This error is returned when an operation is attempted with an account identifier that does not match any existing App Store accounts. * * @see AccountNotFoundError */ ACCOUNT_NOT_FOUND(4040001L), /** - * An error response that indicates the App Store account wasn’t found, but you can try again. + * An error response indicating the App Store account wasn’t found, but you can try again. + * + * This retryable error suggests that the account lookup might have failed due to transient issues or the account may become available shortly. * * @see AccountNotFoundRetryableError */ ACCOUNT_NOT_FOUND_RETRYABLE(4040002L), /** - * An error that indicates the app wasn’t found. + * An error indicating the app wasn’t found. + * + * This error occurs when an operation specifies an app identifier that does not correspond to any apps currently registered in the App Store. * * @see AppNotFoundError */ APP_NOT_FOUND(4040003L), /** - * An error response that indicates the app wasn’t found, but you can try again. + * An error response indicating the app wasn’t found, but you can try again. + * + * Similar to the account not found error, this indicates a potential temporary issue in locating the specified app. * * @see AppNotFoundRetryableError */ APP_NOT_FOUND_RETRYABLE(4040004L), /** - * An error that indicates an original transaction identifier wasn't found. + * An error indicating an original transaction identifier wasn't found. + * + * Occurs when a transaction operation is attempted with an original transaction identifier that is not recognized as valid or existing. * * @see OriginalTransactionIdNotFoundError */ ORIGINAL_TRANSACTION_ID_NOT_FOUND(4040005L), /** - * An error response that indicates the original transaction identifier wasn’t found, but you can try again. + * An error response indicating the original transaction identifier wasn’t found, but you can try again. + * + * Suggests that the failure to find the original transaction identifier might be due to temporary issues or the data may become available shortly. * * @see OriginalTransactionIdNotFoundRetryableError */ ORIGINAL_TRANSACTION_ID_NOT_FOUND_RETRYABLE(4040006L), /** - * An error that indicates that the App Store server couldn’t find a notifications URL for your app in this environment. + * An error indicating the App Store server couldn’t find a notifications URL for your app in this environment. + * + * This error is returned when server-to-server notification setup is incomplete or the provided URL is not recognized. * * @see ServerNotificationUrlNotFoundError */ SERVER_NOTIFICATION_URL_NOT_FOUND(4040007L), /** - * An error that indicates that the test notification token is expired or the test notification status isn’t available. + * An error indicating the test notification token is expired or the test notification status isn’t available. + * + * This error occurs when a test notification token provided for a simulated transaction is no longer valid or the corresponding status cannot be retrieved. * * @see TestNotificationNotFoundError */ TEST_NOTIFICATION_NOT_FOUND(4040008L), /** - * An error that indicates the server didn't find a subscription-renewal-date extension request for the request identifier and product identifier you provided. + * An error indicating the server didn't find a subscription-renewal-date extension request for the request identifier and product identifier provided. + * + * This error is returned when a status request for a subscription renewal-date extension cannot be matched with any submitted extension requests. * * @see StatusRequestNotFoundError */ STATUS_REQUEST_NOT_FOUND(4040009L), /** - * An error that indicates a transaction identifier wasn't found. + * An error indicating a transaction identifier wasn't found. + * + * Occurs when a specific transaction identifier provided in a request does not match any recorded transactions. * * @see TransactionIdNotFoundError */ From e9e336947d30a4cb740c78faca099bb9aff975a3 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 01:04:18 +0100 Subject: [PATCH 16/17] multiple --- .../com/apple/itunes/storekit/client/APIError.java | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index add5c32d..ce4a49d9 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -480,21 +480,27 @@ public enum APIError { TRANSACTION_ID_NOT_FOUND(4040010L), /** - * An error that indicates that the request exceeded the rate limit. + * An error indicating that the request exceeded the rate limit. + * + * This error is returned when a request to the server exceeds the allotted rate limit, suggesting too many requests have been made in a short period. It's a common measure to prevent abuse and overload of the server. * * @see RateLimitExceededError */ RATE_LIMIT_EXCEEDED(4290000L), /** - * An error that indicates a general internal error. + * An error indicating a general internal error within the server. + * + * This broad error category is returned when the server encounters an unexpected condition that prevented it from fulfilling the request. These are often transient and can be retried after some delay. * * @see GeneralInternalError */ GENERAL_INTERNAL(5000000L), /** - * An error response that indicates an unknown error occurred, but you can try again. + * An error response indicating an unknown error occurred, but suggesting that the request may be retried. + * + * Unlike the general internal error, this error specifically suggests that while the error is unknown, retrying the request after some time may result in a successful response. It's indicative of potentially transient server-side issues. * * @see GeneralInternalRetryableError */ From 64d8ced7497c7fa99feda2282d143bc50a6478a3 Mon Sep 17 00:00:00 2001 From: CodingNerd187 Date: Sat, 30 Mar 2024 01:20:10 +0100 Subject: [PATCH 17/17] added @deprecated --- src/main/java/com/apple/itunes/storekit/client/APIError.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/apple/itunes/storekit/client/APIError.java b/src/main/java/com/apple/itunes/storekit/client/APIError.java index ce4a49d9..6c884fdc 100644 --- a/src/main/java/com/apple/itunes/storekit/client/APIError.java +++ b/src/main/java/com/apple/itunes/storekit/client/APIError.java @@ -204,9 +204,10 @@ public enum APIError { * * This deprecated error occurs if the exclude-revoked parameter was not correctly specified, suggesting a format or logical error. * - * @deprecated * @see InvalidExcludeRevokedError */ + + @Deprecated INVALID_EXCLUDE_REVOKED(4000025L), /**