From 1385a3cefc7312a3f18e8d78a854411b53c75e67 Mon Sep 17 00:00:00 2001 From: Ken Date: Wed, 1 Nov 2017 13:27:17 -0400 Subject: Initial commit of the new logs. --- build/html/_sources/players/players.rst.txt | 105 ++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 build/html/_sources/players/players.rst.txt (limited to 'build/html/_sources/players') diff --git a/build/html/_sources/players/players.rst.txt b/build/html/_sources/players/players.rst.txt new file mode 100644 index 0000000..8b21fcb --- /dev/null +++ b/build/html/_sources/players/players.rst.txt @@ -0,0 +1,105 @@ +.. _players: + +Players +======= + +Player objects contain aggregated lifetime information about each Player. At this time Players are fairly sparse, but there are plans to add much richer data as it becomes available. + + + +Get a Single Player +-------------------- + +This endpoint retrieves a specific player. + +*Please Note: Changes Coming! - Player resources are not fully defined at this point, but are included so that consumers can get basic info (name, etc.) This object will have additional data added over the next few months, and may change slightly as data moves from the `attributes.stats` object to the main `attributes` object.* + +**HTTP Request** + +| ``GET https://api.dc01.gamelockerapp.com/shards/na/players/`` + + +**URL Parameters** + +| Parameter: ID +| Description: The ID of the player to retrieve + + +**Shell:** + +.. code-block:: shell + + curl "https://api.dc01.gamelockerapp.com/shards/na/players/" \ + -H "Authorization: Bearer " \ + -H "Accept: application/vnd.api+json" + + **The above command returns JSON structured like this:** + + {{ + "data": { + "attributes": { + "stats": { + "lossStreak": 1, + "winStreak": 0, + "lifetimeGold": 10536.0 + }, + "name": "boombastic04" + }, + "type": "player", + "id": "6abb30de-7cb8-11e4-8bd3-06eb725f8a76" + } + } + + +**Javascript:** + +.. code-block:: javascript + + //There are a variety of Java HTTP libraries that support query-parameters. + + **The above command returns JSON structured like this:** + + {{ + "data": { + "attributes": { + "stats": { + "lossStreak": 1, + "winStreak": 0, + "lifetimeGold": 10536.0 + }, + "name": "boombastic04" + }, + "type": "player", + "id": "6abb30de-7cb8-11e4-8bd3-06eb725f8a76" + } + } + + +Get a Collection of Players +--------------------------- + +This endpoint retrieves a collection of up to 6 players, filtered by name. Player names are specific to each region. If a player has changed names, it is possible that there are multiple ID's for a single player name. + +**HTTP Request** + +| ``GET https://api.dc01.gamelockerapp.com/shards/na/players`` + + +**Query Parameters** + +| Parameter: filter[playerNames] +| Default: None +| Description: Filters by player names. Usage: filter[playerNames]=player1,player2 + + +**Shell:** + +.. code-block:: shell + + curl "https://api.dc01.gamelockerapp.com/shards/na/players?filter[playerNames]=player1,player2" \ + -H "Authorization: Bearer " \ + -H "Accept: application/vnd.api+json" + } + +.. toctree:: + :maxdepth: 2 -- cgit v1.3.1