Comment on page

Notifications 👑

The Notifications API can be used to list the player's notifications and also to update its status once read.

Available Endpoints

Type
Description
Endpoint
GET
/integrations/notifications/{playerUnqiueId}
PUT
/integrations/notifications
This endpoint is only available for our GURU customers only. 👑

GET - Player Notifications

https://api.gameball.co/api/v3.0/integrations/notifications/{playerUnqiueId}/
This API is used to to retrieve a specific player's list of notifications in Gameball.
mobile or email should replace the playerUniqueId in case (only if) your account supports channel merging.

Request

Attribute
Type
Required
Description
APIKey
string
Yes
Client API key

Path Parameters

Attribute
Type
Required
Description
playerUniqueId
string
Yes
Unique identifier for the player at Gameball

Query Parameters

Attribute
Type
Required
Description
isRead
boolean
No
Read status filter. This could be used in case you need to filter notifications based on their read status.
lang
string
No
Language filter. This could be used to specify the language needed to display the notification in. Note: The language provided should be as per configured languages in your account.
Example: "en", "fr".
page
integer
No
Result page number. Starts from 1. Default is 1
limit
integer
No
Result page size. Default is 50 notifications and Max is 200

Response

Returns an array of notification objects described as follows:
Attribute
Type
Description
notifications
array
List of returned notification objects.
count
integer
returned currently displayed notifications list count
total
integer
total number of notifications available matching the applied filters
Example:
"count": 50
"total": 200

notification Object

Attribute
Type
Description
notificationId
string
Unique Identifier for a notification
title
string
Notification Title
body
string
Notification Body
isRead
boolean
Indicates whether the notification is read or not.
createdAt
string
Notification's creation date, as an ISO8601 timestamp.
Example: "2019-09-21T16:53:28.190Z"
lang
string
The language in which the notification is displayed. In case the lang is not provided in the request, defaultlang is returned.
Note: The language provided should be as per configured languages in your account.
Example: "en", "fr".
icon
string
Notification's icon URL.

Sample Response

{
"notifications": [
{
"notificationId" : "123",
"title": "New level!",
"body": "Keep it up! You are now on Bronze ",
"isRead": true,
"createdAt": "2021-05-12T00:08:09.646174",
"lang": "en",
"icon": "https://cdn.gameball.co/uploads/client776/ad8b2587-959f-48fd-ab58-a643323652begb-icon-level-13.png"
},
{
"notificationId" : "124",
"title": "Congratulations! ",
"body": "Welcome earned. Enjoy your rewards and keep earning more!",
"isRead": true,
"createdAt": "2021-05-12T00:08:09.623367",
"lang": "en",
"icon": "https://cdn.gameball.co/uploads/client776/bcc5d9be-3861-415f-bdf9-34b4064a1320Group 2144.png"
}
],
"count": 50,
"total": 200
}

Usage Example

cURL
Ruby
PHP
Python
.NET
curl -X GET -H 'apiKey: 807b041b7d35425988e354e1f6bce186' -v -i
'https://api.gameball.co/api/v3.0/integrations/notifications/player123?lang=en'
# Example 1
Gameball::Notifications.get_notifications("player123")
# Example 2
Gameball::Notifications.get_notifications("player123",{
page: 2,
limit: 10
})
$response = $gameball->notification
->getPlayerNotifications("player123",false, null, 2, 10);
notifications = gameball.get_notifications("player123")
var response = Gameball.GetPlayerNotifications("player123");

PUT - Mark Notification(s) as Read

https://api.gameball.co/api/v3.0/integrations/notifications
The API call is used to mark the player's notification(s) as read in Gameball.

Request

Header

Attribute
Type
Required
Description
APIKey
string
Yes
Client API key

Body

Attribute
Type
Required
Description
notificationIds
array
Yes
An array of IDs of the notifications to be marked as read.
Example: ["12334", "14533", "55343"]

Sample Body

{
"notificationIds" : ["123", "3441", "3245"]
}

Usage Example

cURL
Ruby
PHP
Python
.NET
curl -X PUT -H 'apiKey: 807b041b7d35425988e354e1f6bce186' -d '{
"notificationIds" : ["123", "3441", "3245"]
}' -v -i 'https://api.gameball.co/api/v3.0/integrations/notifications'
Gameball::Notifications.mark_notifications({notificationIds: ["123", "3441", "3245"]})
$response = $gameball->notification
->markPlayerNotificationsAsRead(["123", "3441", "3245"]);
notifications = gameball.mark_notifications(["123", "3441", "3245"])
var response = Gameball.MarkNotifications(new string[]{"123", "3441", "3245"});