Bank Inventory
Endpoint for Bank API
Mobage Simplified Chinese Platform
Production Bank | http://sp.mobage-platform.cn/social/api/restful/v2.02 |
Sandbox Bank | http://sp.sb.mobage-platform.cn/social/api/restful/v2.02 |
Environment | URL |
---|
Mobage Traditional Chinese Platform
Environment | URL |
---|---|
Production Bank | http://sp.mobage-platform.tw/social/api/restful/v2.02 |
Sandbox Bank | http://sp.sb.mobage-platform.tw/social/api/restful/v2.02 |
API Name | HTTP Method | REST URI Fragment | Description |
---|---|---|---|
Get Bank Inventory | GET | /bank/inventory/{appId}/{-list|,|itemId} | Retrieve item resource. |
GET | /bank/inventory/{appId} | Retrieve an collection of item resources. |
Data Type Definition
BankItem
Name | Type | Description |
---|---|---|
id | String | Unique item identifier. ALPHA / DIGIT / "_". 64 or less characters. |
name | String | Item name |
price | Number | Item price |
description | String | Item description |
imageUrl | String | Image URL of the Item |
Get Bank Inventory
Description
Retrieve item resource or collection.
URI Fragment
/bank/inventory/{appId}/{-list|,|itemId}
/bank/inventory/{appId}
Supported Formats
JSON
HTTP Method
GET
REST Query and URI Template Parameters
Name | Type | Required/Optional | Parameter | Description |
---|---|---|---|---|
appId | AppId | Required | URI Template Parameters | Only @app is specifiable |
itemId | ItemId, Array<ItemId> | Optional | URI Template Parameters | |
fields | Array | Optional | Query String | |
format | String | Optional | Query String | Only json is specifiable |
count | Number | Optional | Query String | An integer between 1 and 1000. The default value is 50. |
startIndex | Number | Optional | Query String | An integer of 1 or greater |
Request Headers
Any request to the Mobage REST APIs must include the Authorization header. For more details, see How to add the Authorization Header .
Response Status Code
HTTP Status Code | HTTP Status Message | Meaning |
---|---|---|
200 | OK | Data successfully acquired |
400 | Bad Request | Corrupt request data on the client side |
401 | Unauthorized | Authorization error |
403 | Forbidden | The resource exists, but access is not possible due to a reason other than an authorization error. |
404 | Not Found | The resource doesn’t exist |
500 | Internal Server Error | An error on the API server side |
503 | Service Unavailable | The API cannot be used temporarily |
Response Body
Example 1. Retrieve Single Item's Resource
Example 2. Retrieve All Items' Resources
How to Add the Authorization Header
Step 1. Create the base string
1. build a string for OAuth parameters: firstly sort the following parameters alphabetically and URL encode the names and values, then join name and value with "=", finally join name/value pairs with "&"
Parameter | Description | Value |
---|---|---|
oauth_consumer_key | The Consumer Key for the application | Issued when resist the application |
oauth_nonce | Unique value for each request | Generated on the game server |
oauth_signature_method | Hash method | Only HMAC-SHA1 is specifiable |
oauth_timestamp | UNIX timestamp | Generated on the game server |
oauth_token | The token code | oauth_token is obtained from the token credential. |
oauth_version | OAuth version | Only 1.0 |
2. URL encode the following three parameters.
Parameter | Description |
---|---|
Request Method | HTTP Method to the API Server |
API URL | URL to the API Server (exclude query parameters) |
OAuth Parameters | A string Built in previous step |
3. join the encoded parameters with "&".
Step 2. Generate the oauth_signature
1. Build a secret by joining the Consumer Secret and the Token Secret (obtained from the token credential) with "&"
.
2. Pass the base string and secret to the HMAC-SHA1 hashing algorithm.
3. the output of HMAC-SHA1 hashing algorithm is a binary string. Use base64 encode to produce the signature string.
A tool is provided to verify whether your signature is correct. Refer to Oauth Signature Tool.
Step 3. Build the Authorization Header
Follow the steps to build the “Authorization” header:
1. URL encode the parameter names and values in the table below
2. Double quote the value, join name and value with "=", join name/value pairs with ","
3. Add realm parameter as an option
4. Add "OAuth " (including the space at the end) to the beginning of the header.
Parameter | Value |
---|---|
oauth_consumer_key | Issued when resist the application |
oauth_nonce | Generated on the game server |
oauth_signature | Generated on the game server, Refer to Step 2. Generate the oauth_signature |
oauth_signature_method | only "HMAC-SHA1" is specifiable |
oauth_timestamp | Generated on the game server |
oauth_token | oauth_token is obtained from the token credential. |
oauth_version | Only 1.0 |
Authorization Header Example