Transaction の作成
ゲームアイテム購入するためにトランザクションの新規作成。
備考
Mobage Bank API の使い方
Bank API の詳細な使い方について、下記の各ページをご参照下さい。
ngCore SDK | Native SDK | Unity SDK
URI Fragment
/bank/debit/@app
署名方式
OAuth2
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 ステータスメッセージ | 説明 |
|---|---|---|
| 201 | Created | データの作成が成功した場合 |
| 400 | Bad Request | クライアント側のリクエストデータが不正です |
| 401 | Unauthorized | 認証エラーです |
| 403 | Forbidden | リソースは存在するが認証エラー以外の理由でアクセス出来ない場合です |
| 404 | Not Found | 存在しないリソースです |
| 500 | Internal Server Error | API サーバー側のエラーです |
| 503 | Service 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"}