Put country
===========

This route can be used to edit country field of all scores posted by a given player.

::

    PUT  /v2/:game/:platform/:user

Header
------
.. list-table::
   :widths: 25 75
   :header-rows: 1

   * - Key
     - Value
   * - `Content-Type`
     - `application/json`
   * - `Digest`
     - Signed body (see below)

In order to authorize the score insertion, a signature is required. It consists of a body signature with the HMAC-SHA512 algorithm.

Precisely `signature = BASE64(HMAC-SHA512(body))` with the *game token* as the secret key of `HMAC-SHA512`.

See with the admin for game token issues.

Route parameters
----------------

.. list-table::
   :widths: 25 75
   :header-rows: 1

   * - Key
     - Description
   * - ``:game``
     - the game name
   * - ``:platform``
     - the game platform (e.g. _steam_)
   * - ``:user``
     - the username

Request body
------------

The request body must be send with the ``application/json`` format.

.. list-table::
   :widths: 20 10 70
   :header-rows: 1

   * - Field
     - Required
     - Remarks
   * - ``country``
     - Yes
     - A string value

Example:

.. code:: json

    {
        "country": "nl"
    }

Response
--------

.. list-table::
   :widths: 20 80
   :header-rows: 1

   * - Code
     - Remarks
   * - 204
     - All player scores have been updated with the given country
   * - 400
     - Missing or invalid required field, missing header or invalid signature (see error message)
   * - 401
     - Authentication failed
   * - 500
     - Internal error