購入・ダウンロードAPI Overview購入・ダウンロードAPIは、In app billingでの決済時・決済完了後に利用されるコンテンツ郡です。 In app billingから発行されたレシートはtransactionAPIを利用し、dodaiiに保存、かつdodaiiに設定されている公開鍵を利用してレシートを検証します。 その後、ダウンロード型であれば時限付きダウンロードURLを取得しダウンロードを実行、それ以外のアイテムであれば必要に応じてdodaiiに決済状況の問い合わせを行うことができます。 -購入確認通知(トランザクションの確認・保存)In app billingを利用しての決済処理が完了すると、レシート・シグネチャが取得できますので、そのレシートをdodaiiに送信いただく事で、 dodaiiに設定した公開鍵を利用してレシートを検証し、正しければ「購入履歴」としてサーバに保存します。 本番用(課金が発生します)および開発時のSandboxの両方がご利用いただけます。 無料アイテムについて: dodaiiでは、In app billingを介さず、単純にコンテンツを無料でダウンロードさせることも可能です。その場合、同じくトランザクションAPIに対して、プロダクト番号のみをポストすることで実現しています。 ※無料アイテムのトランザクションは dodaii Panel のアプリケーションステータスが「販売中」の状態でのみ、ご利用できます。dodaii Panel 設定方法につきましては、提出ガイドをご覧下さい。 基本的には「販売中」ステータスのトランザクションは課金対象となりますが、1ヶ月の回数が十数回程度であればテストと見なして、ご請求はしておりません。ただし、同月中に本番利用が始まった場合は、合わせて請求させて頂いております。また、無料アイテムは1課金あたり5円となります。 ●リクエストURL本番用:(アプリケーションステータスが販売中の場合のみ利用可能) https://dodaii.com/api/android/v2/transaction/ SandBox: https://dodaii.com/api/android/v2/transaction/sandbox/ 無料アイテム: https://dodaii.com/api/android/v2/transaction/free/ ●リクエストメソッドPOST ●リクエストパラメータ
●レスポンス
●サンプルレスポンス通常: { "orderIds":[ "475854308172758293_sandbox" ], "original":"{\"nonce\":8457330045213777093,\"orders\":[{\"notificationId\":\"android.test.purchased\",\"orderId\":\"transactionId.android.test.purchased\",\"packageName\":\"com.dodaii.sample\",\"productId\":\"android.test.purchased\",\"purchaseTime\":1357972253300,\"purchaseState\":0}]}" } 無料アイテム: { "files": [ { "displayedName": "aaaaa", "fileId": 2379, "fileName": "IMG_0012.JPG", "id": "1", "locale": "ja", "md5": "96c5c09d4000a8fdea5689e55b5c1afe", "size": 991532 }, { "displayedName": "aaaaa", "fileId": 2380, "fileName": "IMG_0015.JPG", "id": "2", "locale": "ja", "md5": "4124da36998724c07004cf11e4b6bd0a", "size": 1021686 } ], "downloadURL": "https://dl.dodaii.com/api/v2/product/download/", "downloadKey": "f75ed499b13b71e2bac92896e9937869" } ●エラーケース
-ダウンロードURL取得(有料・時限付き)購入後、登録したコンテンツをダウンロードできるURLを発行します。コンテンツ不正取得の対策として、3時間の有効期限を設けています。ユーザーが圏外でダウンロードに失敗するなどで、3時間経過した場合は、再取得のリクエストを行って下さい。 ●リクエストURLhttps://dodaii.com/api/android/v2/product/get/ ●リクエストメソッド POST ●リクエストパラメータ
●レスポンス
ダウンロード対象ファイルのパラメータ
●サンプルレスポンス{ "files": [ { "displayedName": "DISPLAY_NAME(Japanese)", "fileId": 5, "fileName": "iPhonePayment.jpg", "id": "1", "locale": "ja", "md5": "xxxxxxxxxxxxxxx", "size": 27363 } ], "downloadURL": "https://dodaii.com/api/v2/product/download/", "downloadKey": "654557934a958f57b267cxxxxxxxx" } ●エラーケース
購入履歴確認APItokenとapTransactionIdをキーにdodaiiにこのトランザクションが記録されているかどうか確認するAPIです。ダウンロードが伴わない課金プロダクトにご利用ください。 ●リクエストURLhttps://dodaii.com/api/android/v2/transaction/getproductid/<token>/<apTransactionId> ●リクエストパラメータ
●レスポンス
●サンプルレスポンス(通常){"PRODUCT_IDENTIFIER":"addpicture001","responce":"1"}●エラーケース
ダウンロードAPIトランザクションで取得したAPIURLに、以下のパラメータをPOSTで送信するとダウンロード可能です。 ●リクエストURLhttps://dodaii.com/api/android/v2/product/download/ ●リクエストパラメータ
●レスポンス商品のバイナリデータが返却されます。 ●エラーケース
|
アプリ内課金(Android) > APIリファレンス-v2 >