Поля получения
Получения составлены из многих полей. Некоторые поля только доступны локально, в форме ASN.1 получения, или только при проверке с App Store, в форме JSON получения. Ключи, не задокументированные ниже, резервируются для использования Apple и должны быть проигнорированы Вашим приложением.
Поля получения приложения
Идентификатор пакета
Идентификатор пакета приложения.
Тип поля ASN.1 2
Значение поля UTF8STRING ASN.1
Имя поля JSON bundle_id
Строка Значения поля JSON
Это соответствует значению CFBundleIdentifier
в Info.plist
файл.
Версия приложения
Номер версии приложения.
Тип поля ASN.1 3
Значение поля UTF8STRING ASN.1
Имя поля JSON application_version
Строка Значения поля JSON
Это соответствует значению CFBundleVersion
(в iOS) или CFBundleShortVersionString
(в OS X) в Info.plist
.
Непрозрачное значение
Непрозрачное используемое значение, с другими данными, для вычислений хеша SHA 1 во время проверки.
Тип поля ASN.1 4
Значение поля ASN.1 ряд байтов
Имя поля JSON (ни один)
Значение поля JSON (ни один)
Хеш SHA 1
Хеш SHA 1, используемый для проверки получения.
Тип поля ASN.1 5
Обзор SHA 1 20 байтов Значения поля ASN.1
Имя поля JSON (ни один)
Значение поля JSON (ни один)
Получение закупки в приложении
Получение для закупки в приложении.
Тип поля ASN.1 17
Значение поля ASN.1 SET закупки в приложении подтверждает получение атрибутов
Имя поля JSON in_app
Массив Значения поля JSON получений закупки в приложении
В файле JSON значение этого ключа является массивом, содержащим все получения закупки в приложении. В файле ASN.1 существуют многократные поля, что у всех есть тип 17, каждый из которых содержит единственное получение закупки в приложении.
Когда покупка совершена, получение закупки в приложении для потребляемого продукта добавляется к получению. Это сохранено в получении до Ваших концов приложения та транзакция. После той точки это удалено из получения в следующий раз, когда получение обновляется — например, когда пользователь совершает другую покупку или если Ваше приложение явно обновляет получение.
Получение закупки в приложении для непотребляемого продукта, автовозобновляемой подписки, невозобновляя подписку или бесплатную подписку остается в получении неопределенно.
Версия исходного приложения
Версия первоначально купленного приложения.
Тип поля ASN.1 19
Значение поля UTF8STRING ASN.1
Имя поля JSON original_application_version
Строка Значения поля JSON
Это соответствует значению CFBundleVersion
(в iOS) или CFBundleShortVersionString
(в OS X) в Info.plist
файл, когда была первоначально совершена покупка.
В среде песочницы значение этого поля всегда «1.0».
Получения до 20 июня 2013 опускают это поле. Это заполняется на всех новых получениях, независимо от версии ОС. Если Вам нужно поле, но оно отсутствует, вручную обновите получение с помощью SKReceiptRefreshRequest
класс.
Подтвердите получение даты истечения срока
Дата, что истекает получение приложения.
Тип поля ASN.1 21
Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339
Имя поля JSON expiration_date
Значение поля IA5STRING JSON, интерпретируемое как дата RFC 3339
Этот ключ присутствует только для приложений, купленных через Программу Закупки Объема. Если этот ключ не присутствует, получение не истекает.
При проверке получения сравните эту дату с текущей датой, чтобы определить, истекает ли получение. Не пытайтесь использовать эту дату для вычисления любой другой информации, такой как время, оставаясь перед истечением срока.
Поля получения закупки в приложении
Количество
Число элементов куплено.
Тип поля ASN.1 1701
Значение поля ASN.1 INTEGER
Количество Имени поля JSON
Строка Значения поля JSON, интерпретируемая как целое число
Это значение соответствует quantity
свойство SKPayment
объект хранится в транзакции payment
свойство.
Идентификатор продукта
Идентификатор продукта купленного элемента.
Тип поля ASN.1 1702
Значение поля UTF8STRING ASN.1
Имя поля JSON product_id
Строка Значения поля JSON
Это значение соответствует productIdentifier
свойство SKPayment
объект хранится в транзакции payment
свойство.
Идентификатор транзакции
Идентификатор транзакции купленного элемента.
Тип поля ASN.1 1703
Значение поля UTF8STRING ASN.1
Имя поля JSON transaction_id
Строка Значения поля JSON
Это значение соответствует транзакции transactionIdentifier
свойство.
Исходный идентификатор транзакции
Для транзакции, восстанавливающей предыдущую транзакцию, идентификатор транзакции исходной транзакции. Иначе, идентичный идентификатору транзакции.
Тип поля ASN.1 1705
Значение поля UTF8STRING ASN.1
Имя поля JSON original_transaction_id
Строка Значения поля JSON
Это значение соответствует исходной транзакции transactionIdentifier
свойство.
Все получения в цепочке возобновлений для автовозобновляемой подписки имеют то же значение для этого поля.
Дата покупки
Дата и время, что был куплен элемент.
Тип поля ASN.1 1704
Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339
Имя поля JSON purchase_date
Строка Значения поля JSON, интерпретируемая как дата RFC 3339
Это значение соответствует транзакции transactionDate
свойство.
Для транзакции, восстанавливающей предыдущую транзакцию, дата покупки является датой восстановления. Используйте Исходную Дату покупки для получения даты исходной транзакции.
В автовозобновляемом получении подписки это - всегда дата, когда подписка была куплена или возобновлена, независимо от того, была ли восстановлена транзакция.
Исходная дата покупки
Для транзакции, восстанавливающей предыдущую транзакцию, дату исходной транзакции.
Тип поля ASN.1 1706
Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339
Имя поля JSON original_purchase_date
Строка Значения поля JSON, интерпретируемая как дата RFC 3339
Это значение соответствует исходной транзакции transactionDate
свойство.
Даже если подписка была возобновлена, в автовозобновляемом получении подписки это указывает начало периода подписки.
Дата истечения срока подписки
Дата истечения срока подписки, выраженной как число миллисекунд с 1 января 1970, 0:00:00 GMT.
Тип поля ASN.1 1708
Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339
Имя поля JSON expires_date
Число Значения поля JSON
Этот ключ только присутствует для автовозобновляемых получений подписки.
Дата отмены
Для транзакции, отмененной поддержкой клиентов Apple, время и дата отмены.
Тип поля ASN.1 1712
Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339
Имя поля JSON cancellation_date
Строка Значения поля JSON, интерпретируемая как дата RFC 3339
Обработайте отмененное получение то же, как будто никогда не совершалась никакая покупка.
Элемент приложения ID
Строка, что использование App Store для однозначного определения приложения, создавшего транзакцию.
Тип поля ASN.1 (ни один)
Значение поля ASN.1 (ни один)
Имя поля JSON app_item_id
Строка Значения поля JSON
Если Ваш сервер поддерживает многократные приложения, можно использовать это значение для дифференциации между ними.
Приложения присваиваются идентификатор только в продуктивной среде, таким образом, этот ключ не присутствует для получений, создаваемых в тестовой среде.
Это поле не присутствует для приложений Mac.
См. также Идентификатор Пакета.
Внешний идентификатор версии
Произвольное число, однозначно определяющее версию Вашего приложения.
Тип поля ASN.1 (ни один)
Значение поля ASN.1 (ни один)
Имя поля JSON version_external_identifier
Строка Значения поля JSON
Этот ключ не присутствует для получений, создаваемых в тестовой среде.
Позиция интернет-заказа ID
Первичный ключ для идентификации покупок подписки.
Тип поля ASN.1 1711
Значение поля ASN.1 INTEGER
Имя поля JSON web_order_line_item_id
Строка Значения поля JSON