This page describes the API for external app developers who wish to save game\u00a0sessions in the personal data store of a GameBus user.<\/p>\n
Integrating an external game with the GameBus Open API enables\u00a0GameBus sponsors to define challenges in terms of sessions of that external game.\u00a0Then, furthermore, end users can gain GameBus points by playing the external game. As the developer of mobile games, there are various\u00a0incentives for realizing this integration:<\/p>\n
First, the external app needs access to a\u00a0user-specific token for the GameBus API<\/a>.<\/p>\n Second, the external app needs to describe its metadata on the GameBus platform. Specifically, you will have to provide a so-called “game descriptor” for the app, listing which properties are available for each game session. \u00a0For each property, a type needs to be specified. The currently -available types are:<\/p>\n In summary, for your external app, you should supply the following metadata:<\/p>\n In order to\u00a0register your game descriptor, please contact info@gamebus.eu<\/a>. Please also clarify\u00a0how you plan to\u00a0explain to end users what kind of data you are sending to GameBus. Specifically, please send us your (draft) policy description, so we can include it later in the GameBus terms of use \/ privacy policy. We will contact you soon after, clarifying:<\/p>\n Once you have your own game descriptor, you\u00a0can finalize\u00a0the actual integration code.\u00a0In the following, we assume that we have registered your game descriptor and we also assume that your external app has access to a user-specific GameBus OAuth token<\/a>.<\/p>\n To push a new session, you should make an HTTPS REST call with JSON payload and an OAuth 2 token<\/a> in the Authorization header<\/a>.<\/p>\n In this example, the “name” and “type” attributes are provided just for documentation purposes. They are fully ignored by our API since the actual property name and type information is already known inside GameBus. Put differently, only the attributes “id” and “value” matter in the array of property instance.<\/p>\n That’s all!<\/p>\n","protected":false},"excerpt":{"rendered":" What? This page describes the API for external app developers who wish to save game\u00a0sessions in the personal data store of a GameBus user. Why? Integrating an external game with the GameBus Open API enables\u00a0GameBus sponsors to define challenges in terms of sessions of that external game.\u00a0Then, furthermore, end users can gain GameBus points by … <\/p>\n\n
\n
\n
\n
{\n \"gameDescriptorId\": 101,\n \"properties\": [\n {\n \"id\": 1001,\n \"value\": \"2015-09-29\",\n \"name\": \"Started at date\",<\/em>\n \"type\": \"DATE\"<\/em>\n },\n {\n \"id\": 1002,\n \"value\": \"01:30 AM\",\n \"name\": \"Started at time\",\n \"type\": \"TIME\"<\/em>\n },\n {\n \"id\": 1003,\n \"value\": 72,\n \"name\": \"Seconds to Complete\",\n \"type\": \"INT\"<\/em>\n },\n {\n \"id\": 1004,\n \"value\": 321,\n \"name\": \"Score\",\n \"type\": \"INT\"<\/em>\n },\n {\n \"id\": 1005,\n \"value\": 123,\n \"name\": \"Level\",\n \"type\": \"INT\"<\/em>\n }\n ]\n}<\/code><\/pre>\n