Methods & parameters

THIS DOCUMENTATION WILL CONSUME A JSON RESPONSE.

Table of the contents

1. Create Session
2. Ping
3. Test Session
4. Get Leaderboard
5. Get Match Details
6. Get Match Ids By Queue
7. Get Player
8. Get Player Match History
9. Get Player Stats

Connectivity

Create Session

/createsession[ResponseFormat]/{devID}/{signature}/{timestamp}

A required step to Authenticate the developerId/signature for further API use.

Parameter	Description	Example
ResponseFormat	JSON or XML	json
devID	Your devID from your application request	1004
signature	The signature of "createsession" method	c332691773af33948c9ddb12e5fb444f
timestamp	The current timestamp	20180628012612

Request: http://api.realmroyale.com/realmapi.svc/createsessionjson/1004/c332691773af33948c9ddb12e5fb444f/20180628012612

Response: JSON

{
    "ret_msg": "Approved",
    "session_id": "1465AFCA32DBDB800CEF8C72F296C52C",
    "timestamp": "6/28/2018 1:26:12 AM"
}

The sessionId is contained in an element called “session_id”. This parameter is needed to call the other methods.

---

Ping

/ping[ResponseFormat]

A quick way of validating access to the Realm Royale API.

Parameter	Description	Example
ResponseFormat	JSON or XML	json

Request: http://api.realmroyale.com/realmapi.svc/pingjson

Response: TEXT PLAIN

RealmAPI (ver 1.0.0.0) [PATCH - ] - Ping successful. Server Date:6/28/2018 1:26:12 AM

---

Test Session

/testsession[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}

A means of validating that a session is established.

Parameter	Description	Example
ResponseFormat	JSON or XML	json
devID	Your devID from your application request	1004
signature	The signature of "testsession" method	c332691773af33948c9ddb12e5fb444f
session	A valid session_id	1465AFCA32DBDB800CEF8C72F296C52C
timestamp	The current timestamp	20180628012612

Request: http://api.realmroyale.com/realmapi.svc/testsessionjson/1004/c332691773af33948c9ddb12e5fb444f/1465AFCA32DBDB800CEF8C72F296C52C/20180628012612

Response: TEXT PLAIN

This was a successful test with the following parameters added: developer: 1004 time: 6/28/2018 1:26:12 AM signature: c332691773af33948c9ddb12e5fb444f session: 1465AFCA32DBDB800CEF8C72F296C52C

---

APIs

Get Player

/getPlayer[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}/{player}/hirez

http://api.realmroyale.com/realmapi.svc/getPlayerJSON/{devId}/{signature}/{session}/{timestamp}/{player}/hirez

Get Player Stats

/getPlayerStats[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}/{player}

http://api.realmroyale.com/realmapi.svc/getPlayerStatsJSON/{devId}/{signature}/{session}/{timestamp}/{player}

Get Player Match History

/getPlayerMatchHistory[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}/{player}

http://api.realmroyale.com/realmapi.svc/getPlayerMatchHistoryJSON/{devId}/{signature}/{session}/{timestamp}/{player}

Get Leaderboard

/getLeaderboard[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}/{queue}/{ranking_criteria}

http://api.realmroyale.com/realmapi.svc/getLeaderboardJSON/{devId}/{signature}/{session}/{timestamp}/{queue}/{ranking_criteria}

Get Match IDs By Queue

/getMatchIDsByQueue[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}/{queue}/{date}/{hour}

http://api.realmroyale.com/realmapi.svc/getMatchIDsByQueueJSON/{devId}/{signature}/{session}/{timestamp}/{queue}/{date}/{hour}

Get Match Details

/getMatchDetails[ResponseFormat]/{devId}/{signature}/{session}/{timestamp}/{matchId}

http://api.realmroyale.com/realmapi.svc/getMatchDetailsJSON/{devId}/{signature}/{session}/{timestamp}/{matchId}