TheGamDevStore.com Online API

TGDSO Metadata

TGDSO Metadata

Single and Group shared Cloud-based Data Storage system

Some things developers have achieved with the Metadata Storage system:

  • Global Game Statistics
  • User-Specific Statistics
  • Private Messaging System
  • User-Generated Content Hosting, e.g. Level Packs
  • Turn Based Strategy Games
  • Instant Replay System

Note:

Metadata Value is limited to 16MB per key.


GET

Returns values from the Metadata Key. Returns all the keys in either the game’s global Metadata, or all the keys in a user’s Metadata. Note that we suggest using the dump format for returning data from this Request.

Request

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"method":"Metadata_GET",   Service Transaction Method.
"params":{    
 "signature":"6e73861fd2d75a76e54b472e609eaf98",xhashPrevious Signed Authentication Token issued by TGDSO Contest Server.
 "group":"alphaFaction",
 stringGroup to retrieve item from. Values: Groupname, Global. If omitted Returns User’s Metadata.
 "keys":["techlordx", "gamaster4"]xstring arrOne or more Item Keys to retrieve.
},    
"id": 4}    

Response

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result": {    
 "signature":"3208fde0470719372f8313ddd5884a75",xhashSigned Authentication Token issued by TGDSO Contest Server.
 "metadata":[  List of Metadata start here
 {"key":"somemetadata",xintKey
 "value":"datadump"}xstringThe item’s data. Suggested Format: dump format.
 ]  Additional Metadata objects follow.
},    
"id": 4}    
JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result":{    
 "failure":1xintegerFailure Code 1: Authentication Failed. Incorrect Username/Password Combination.
},    
"id": 4}    

SET

Sets one or more metadata values.

Request

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"method":"Metadata_SET",   Service Transaction Method.
"params":{    
 "signature":"6e73861fd2d75a76e54b472e609eaf98", hashPrevious Signed Authentication Token issued by TGDSO Contest Server.
 "group":"alphaFaction", stringGroup to retrieve item from. Values: Groupname, Global. If omitted Sets User’s Metadata.
 "metadata":[   
 {"key":"somemetadata",xstring arrThe username(s)  that you’d like to retrieve. An array is used to get 1 or more users.
 "value":"techlordx"}   
 ]   
},    
"id": 4}    

Response

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result": {    
 "signature":"3208fde0470719372f8313ddd5884a75"xhashSigned Authentication Token issued by TGDSO Contest Server.
},    
"id": 4}    
JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result":{    
 "failure":1xintegerFailure Code 1: Authentication Failed. Incorrect Username/Password Combination.
},    
"id": 4}    

UPDATE

Updates one or more metadata values.

Request

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"method":"Metadata_UPDATE",   Service Transaction Method.
"params":{    
 "signature":"6e73861fd2d75a76e54b472e609eaf98",xhashPrevious Signed Authentication Token issued by TGDSO Contest Server.
 "group":"alphaFaction", stringGroup to retrieve item from. Values: Groupname, Global. If omitted Sets User’s Metadata.
 "metadata":[ object arr 
 {"key":"somemetadata",xstringThe items  that you’d like to update. An array is used to get 1 or more users.
 "operation":"techlordx" stringThe operation that you’d like to perform.
The mathematic operations are add, subtract, multiply and divide. The string operations are append and prepend.
Note: you can only perform mathematic operations on numeric data..
 "value":"data goes here"} x stringThe value to work on in the metadata.
 ]   
},    
"id": 4}    

Response

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result": {    
 "signature":"3208fde0470719372f8313ddd5884a75",xhashSigned Authentication Token issued by TGDSO Contest Server.
 "metadata":[  List of Metadata start here
 {"key":"somemetadata",xintKey
 "value":"datadump"}xstringThe item’s data. Suggested Format: dump format.
 ]  Additional Metadata objects follow.
},    
"id": 4}    
JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result":{    
 "failure":1xintegerFailure Code 1: Authentication Failed. Incorrect Username/Password Combination.
},    
"id": 4}    

DELETE

Delete one more metadata values.

Request

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"method":"Metadata_DELETE",   Service Transaction Method.
"params":{    
 "signature":"6e73861fd2d75a76e54b472e609eaf98",xhashPrevious Signed Authentication Token issued by TGDSO Contest Server.
 "group":"alphaFaction",
 stringGroup to retrieve item from. Values: Groupname, Global. If omitted Returns User’s Metadata.
 "keys":["techlordx", "gamaster4"]xstring arrOne or more Item Keys to remove.
},    
"id": 4}    

Response

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result": {    
 "signature":"3208fde0470719372f8313ddd5884a75"xhashSigned Authentication Token issued by TGDSO Contest Server.
},    
"id": 4}    
JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result":{    
 "failure":1xintegerFailure Code 1: Authentication Failed. Incorrect Username/Password Combination.
},    
"id": 4}    

Submit a Comment

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Pin It on Pinterest