メインコンテンツまでスキップ

Transaction の作成

 

ゲームアイテム購入するためにトランザクションの新規作成。

備考

Mobage Bank API の使い方
Bank API の詳細な使い方について、下記の各ページをご参照下さい。
ngCore SDK | Native SDK | Unity SDK

URI Fragment​

/bank/debit/@app

署名方式​

OAuth2

備考

OAuth 認証についてはこちら、リクエストの署名や Authorization ヘッダーの作成についてはこちらを参照して下さい。

HTTP メソッド​

POST

リクエストヘッダー​

  • Authorization は必須になります。例に示した "Authorization: bearer oauth2_token" を HTTP ヘッダーに追加して下さい。
  • Content-Type: application/json; charset=utf-8

URL クエリパラメータ​

なし

リクエスト本体​

下記キーと値を持つ JSON 文字列。下記実例もご参照下さい。

{
"items": [{ // アイテム配列。ただいまアイテムは 1 つだけ指定可能
"item": { // 下記パラメータを持つオブジェクト
"id":"item_1", // 購入対象アイテム ID
// Mobage Developers に予め登録する必要はありません
"name":"Sample Item", // アイテム名
"price":100, // アイテム価格
"description":"This is a sample item", // アイテムの説明文
"imageUrl":"http:\/\/mobage.com\/icon.png" // アイテム画像の URL
},
"quantity":2 // 本トランザクションで購入するアイテム個数
}],
"comment":"Purchase of 2 Sample Item(s)", // 本トランザクションに対するコメント、Mobage ユーザの通帳に表示されます
"state":"new" // "new" を指定して下さい
}

レスポンスコード​

HTTP ステータスコードHTTP ステータスメッセージ説明
201Createdデータの作成が成功した場合
400Bad Requestクライアント側のリクエストデータが不正です
401Unauthorized認証エラーです
403Forbiddenリソースは存在するが認証エラー以外の理由でアクセス出来ない場合です
404Not Found存在しないリソースです
500Internal Server ErrorAPI サーバー側のエラーです
503Service Unavailable一時的に API が利用不可となっている場合です

レスポンス本文​

  • 成功の場合、作成されたトランザクション ID が返ってきます。

  • Content-Type: application/json; charset=utf-8

パラメータ名型説明
id文字列新規作成されたトランザクションの ID

実例​

Base String

// OAuth2 認証では Base String は必要ありません。

Http リクエスト

POST /social/api/restful/v2.02/bank/debit/@app HTTP/1.1
Host: ssl.sb.sp.mbga-platform.jp
Accept-Encoding: gzip
Authorization: bearer 1126d0ba1d9e48ed3542c450318811b3
Accept: */*
Content-Type: application/json; charset=utf-8
Content-Length: 243

{"items":[{"item":{"id":"item_1","name":"Sample Item","price":100,"description":"This is a sample item","imageUrl":"http:\/\/mobage.com\/homepage-assets\/images\/icon.png"},"quantity":2}],"comment":"Purchase of 2 Sample Item(s)","state":"new"}

HTTP レスポンス

HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 45
Connection: close
Date: Mon, 28 Oct 2013 07:22:28 GMT
Server: Unknown

{"id":"20EDBD5D-A858-38F7-BF65-A097394AC80C"}
  • URI Fragment
  • 署名方式
  • HTTP メソッド
  • リクエストヘッダー
  • URL クエリパラメータ
  • リクエスト本体
  • レスポンスコード
  • レスポンス本文
  • 実例