app store server library javaダウンロード - app store server library javaソースコードのダウンロード

app store server library java

JAVAソースコード

Release 3.2.0

ダウンロード

Apple App Store サーバー Java ライブラリ

App Store サーバー API および App Store サーバー通知用の Java サーバーライブラリ。 Swift、Python、Node.js でも利用できます。

インストール

要件

Java 11+

グラドル

implementation ' com.apple.itunes.storekit:app-store-server-library:3.2.0 '

メイビン

< dependency >
    < groupId >com.apple.itunes.storekitgroupId >
    < artifactId >app-store-server-libraryartifactId >
    < version >3.2.0version >
dependency >

ドキュメント

JavaDocs

WWDC ビデオ

App Store ConnectからIn-App Purchaseキーを取得する

App Store サーバー API を使用するか、プロモーションオファーの署名を作成するには、App Store Connect からダウンロードした署名キーが必要です。このキーを取得するには、管理者の役割が必要です。 [ユーザーとアクセス] > [統合] > [アプリ内購入] に移動します。ここでキーを作成および管理したり、発行者 ID を検索したりできます。キーを使用する場合は、キー ID と発行者 ID も必要になります。

Apple ルート証明書の取得

Apple PKI サイトの Apple ルート証明書セクションにあるルート証明書をダウンロードして保存します。これらの証明書を配列として SignedDataVerifier に提供すると、署名されたデータが Apple からのものであることを検証できるようになります。

使用法

APIの使用法

 import com . apple . itunes . storekit . client . APIException ;
import com . apple . itunes . storekit . client . AppStoreServerAPIClient ;
import com . apple . itunes . storekit . model . Environment ;
import com . apple . itunes . storekit . model . SendTestNotificationResponse ;

import java . io . IOException ;
import java . nio . file . Files ;
import java . nio . file . Path ;

public class APIExample {
    public static void main ( String [] args ) throws Exception {
        String issuerId = "99b16628-15e4-4668-972b-eeff55eeff55" ;
        String keyId = "ABCDEFGHIJ" ;
        String bundleId = "com.example" ;
        Path filePath = Path . of ( "/path/to/key/SubscriptionKey_ABCDEFGHIJ.p8" );
        String encodedKey = Files . readString ( filePath );
        Environment environment = Environment . SANDBOX ;

        AppStoreServerAPIClient client =
                new AppStoreServerAPIClient ( encodedKey , keyId , issuerId , bundleId , environment );

        try {
            SendTestNotificationResponse response = client . requestTestNotification ();
            System . out . println ( response );
        } catch ( APIException | IOException e ) {
            e . printStackTrace ();
        }
    }
}

検証の使用法

 import com . apple . itunes . storekit . model . Environment ;
import com . apple . itunes . storekit . model . ResponseBodyV2DecodedPayload ;
import com . apple . itunes . storekit . verification . SignedDataVerifier ;
import com . apple . itunes . storekit . verification . VerificationException ;

import java . io . FileInputStream ;
import java . io . InputStream ;
import java . util . Set ;

public class ExampleVerification {
    public static void main ( String [] args ) {
        String bundleId = "com.example" ;
        Environment environment = Environment . SANDBOX ;
        Set < InputStream > rootCAs = Set . of (
                new FileInputStream ( "/path/to/rootCA1" ),
                new FileInputStream ( "/path/to/rootCA2" )
        );
        Long appAppleId = null ; // appAppleId must be provided for the Production environment

        SignedDataVerifier signedPayloadVerifier = new SignedDataVerifier ( rootCAs , bundleId , appAppleId , environment , true );
        
        String notificationPayload = "ey..." ;

        try {
            ResponseBodyV2DecodedPayload payload = signedPayloadVerifier . verifyAndDecodeNotification ( notificationPayload );
            System . out . println ( payload );
        } catch ( VerificationException e ) {
            e . printStackTrace ();
        }
    }
}

レシートの利用方法

 import com . apple . itunes . storekit . client . AppStoreServerAPIClient ;
import com . apple . itunes . storekit . client . GetTransactionHistoryVersion ;
import com . apple . itunes . storekit . migration . ReceiptUtility ;
import com . apple . itunes . storekit . model . Environment ;
import com . apple . itunes . storekit . model . HistoryResponse ;
import com . apple . itunes . storekit . model . TransactionHistoryRequest ;

import java . nio . file . Files ;
import java . nio . file . Path ;
import java . util . LinkedList ;
import java . util . List ;

public class ExampleMigration {
    public static void main ( String [] args ) throws Exception {
        String issuerId = "99b16628-15e4-4668-972b-eeff55eeff55" ;
        String keyId = "ABCDEFGHIJ" ;
        String bundleId = "com.example" ;
        Path filePath = Path . of ( "/path/to/key/SubscriptionKey_ABCDEFGHIJ.p8" );
        String encodedKey = Files . readString ( filePath );
        Environment environment = Environment . SANDBOX ;

        AppStoreServerAPIClient client =
                new AppStoreServerAPIClient ( encodedKey , keyId , issuerId , bundleId , environment );

        String appReceipt = "MI..." ;
        ReceiptUtility receiptUtil = new ReceiptUtility ();
        String transactionId = receiptUtil . extractTransactionIdFromAppReceipt ( appReceipt );
        if ( transactionId != null ) {
            TransactionHistoryRequest request = new TransactionHistoryRequest ()
                    . sort ( TransactionHistoryRequest . Order . ASCENDING )
                    . revoked ( false )
                    . productTypes ( List . of ( TransactionHistoryRequest . ProductType . AUTO_RENEWABLE ));
            HistoryResponse response = null ;
            List < String > transactions = new LinkedList <>();
            do {
                String revision = response != null ? response . getRevision () : null ;
                response = client . getTransactionHistory ( transactionId , revision , request , GetTransactionHistoryVersion . V2 );
                transactions . addAll ( response . getSignedTransactions ());
            } while ( response . getHasMore ());
            System . out . println ( transactions );
        }
    }
}

プロモーションオファーの署名の作成

 import com . apple . itunes . storekit . offers . PromotionalOfferSignatureCreator ;

import java . nio . file . Files ;
import java . nio . file . Path ;
import java . util . UUID ;

public class ExampleSignatureCreation {
    public static void main ( String [] args ) throws Exception {
        String keyId = "ABCDEFGHIJ" ;
        String bundleId = "com.example" ;
        Path filePath = Path . of ( "/path/to/key/SubscriptionKey_ABCDEFGHIJ.p8" );
        String encodedKey = Files . readString ( filePath );

        PromotionalOfferSignatureCreator signatureCreator = new PromotionalOfferSignatureCreator ( encodedKey , keyId , bundleId );
        
        String productId = "" ;
        String subscriptionOfferId = "" ;
        String appAccountToken = "" ;
        UUID nonce = UUID . randomUUID ();
        long timestamp = System . currentTimeMillis ();
        String encodedSignature = signatureCreator . createSignature ( productId , subscriptionOfferId , appAccountToken , nonce , timestamp );
        System . out . println ( encodedSignature );
    }
}