r4nkt
Search…
Concepts
Cookbook
API
Webhooks
PHP SDK
Laravel Package
Events
Introduction
Each time a given event occurs, r4nkt will notify you via a webhook. This page will list and describe the various events that can be fired.
No webhook will be called if the game's webhook URL and webhook secret properties haven't been properly set up.
Common Payload
Each webhook will contain some common data in its payload:
type: This value is used to indicate the webhook type.date_time_utc: This indicates the date/time for the event represented by the webhook. It will be an ISO 8601 UTC date/time representation, eg2019-02-01T03:45:27.612584Z.
Here is what the common elements of a sample payload might look like:
1
{
2
"type":"badge-earned",
3
"date_time_utc":"2019-02-01T03:45:27.612584Z",
4
...
5
}
Copied!
Badge Earned
When a player earns a new badge, r4nkt will send a "badge earned" webhook. In addition to the common payload data, this webhook also includes the following:
custom_player_id: The custom ID for the player that earned the badge.custom_achievement_id: The custom ID for the related achievement.points: The number of points that were allocated to the player for having earned the badge.
Here is a sample payload:
1
{
2
"type":"badge-earned",
3
"date_time_utc":"2019-02-01T03:45:27.612584Z",
4
"custom_player_id":"",
5
"custom_achievement_id":"",
6
"points":100
7
}
Copied!
Webhook Test
This webhook is sent from the game dashboard's webhhook settings panel and is manually initiated by any user with access. It is used to help get webhook integration up and running. In addition to the common payload data, this webhook also includes the following:
inspiring_quote: This serves two purposes. First, it provides additional data so that developers have a little better idea about what to expect. Second, it can serve to inspire. 😊
Here is a sample payload:
1
{
2
"type":"webhook-test",
3
"date_time_utc":"2019-02-01T03:45:27.612584Z",
4
"inspiring_quote":"He who is contented is rich. - Laozi"
5
}
Copied!
Testing
In order to test and debug, you might like to use a service like RequestBin.com or webhook.site, which can show you the payload of the webhook data in real-time.
Last modified 6mo ago
Copy link