anchor.diff:  
   + Response 500
           
  -## Ranking Query [/rankings/{rnk}?top=7&bottom=9]        
  +## Ranking Admin [/rankings/inventory/{rnk}]        
  +### Gets all the info regarding one ranking [GET]
  +Returns the full information that defines a ranking.  
  +The data returned is the following:
  +
  +* **active**: if the ranking is active or not
  +* **properties**: a set of [properties] (#ranking_properties) that define the behaviour of the ranking
  +* **collection**: the [collection] (#ranking_collections) of the ranking
  +* **platforms**: the collection of [Platforms] (#platform_model) in which the ranking will be available. The "default" fields are not mandatory, if they are not specified the first element in the list will be considered the 'default'
  +
  +
  ++ Parameters
  +    + rnk (string)... the id of the new ranking
  +
  ++ Response 200
  +
  +    + Body
  +        
  +            {
  +                    "active": true,
  +                    "collection": "all",
  +                    "properties": [
  +                        {"validityTime": "ETERNAL"}
  +                            ],
  +                    "platforms":[
  +                    {
  +                        "platform": "web",
  +                        "languages": [
  +                            {
  +                                "lang": "en",
  +                                "name": "NYC Rnk",
  +                                "desc": "The New York City Ranking",
  +                                "default": true
  +                            },
  +                            {
  +                                "lang": "es",
  +                                "name": "NYC Rnk",
  +                                "desc": "El ranking de Nueva York"
  +                            }
  +                        ],
  +                        "default": true
  +                    },
  +                    {
  +                        "platform": "iphone",
  +                        "languages": [
  +                            {
  +                                "lang": "en",
  +                                "name": "NYC Rnk",
  +                                "desc": "The NYC Ranking"
  +                            },
  +                            {
  +                                "lang": "es",
  +                                "name": "NYC Rnk",
  +                                "desc": "El ranking de NY"
  +                            }
  +                        ]
  +                    },
  +                ]
  +            }
  +
  ++ Response 400 (application/json)
  +
  +        {
  +            "result": {
  +                "code": 400,
  +                "extended": {
  +                    [
  +                        {
  +                            "code": "E400-WRONG-PARAMETER",
  +                            "desc": "The parameter [param-name] was wrong"
  +                        }
  +                    ]
  +                }
  +            }
  +        }
  +
  ++ Response 500
  +
  +
  +### Creates a new ranking [PUT]
  +Registers a new ranking. A ranking can be overwritten as many times as needed as long as it has not
  +members registered, once there is at least one member registered, the ranking can only be modified or 
  +deleted.   
  +The data that define a ranking are the following:
  +
  +* **active**: if the ranking is active or not
  +* **properties**: a set of [properties] (#ranking_properties) that define the behaviour of the ranking
  +* **collection**: the [collection] (#ranking_collections) of the ranking
  +* **platforms**: the collection of [Platforms] (#platform_model) in which the ranking will be available. The "default" fields are not mandatory, if they are not specified the first element in the list will be considered the 'default'
  +
  +
  ++ Parameters
  +    + rnk (string)... the id of the new ranking
  +
  ++ Request (application/json)
  +    + Body
  +        
  +            {
  +                    "active": true,
  +                    "collection": "all",
  +                    "properties": [
  +                        {"validityTime": "ETERNAL"}
  +                            ],
  +                    "platforms":[
  +                    {
  +                        "platform": "web",
  +                        "languages": [
  +                            {
  +                                "lang": "en",
  +                                "name": "NYC Rnk",
  +                                "desc": "The New York City Ranking",
  +                                "default": true
  +                            },
  +                            {
  +                                "lang": "es",
  +                                "name": "NYC Rnk",
  +                                "desc": "El ranking de Nueva York"
  +                            }
  +                        ],
  +                        "default": true
  +                    },
  +                    {
  +                        "platform": "iphone",
  +                        "languages": [
  +                            {
  +                                "lang": "en",
  +                                "name": "NYC Rnk",
  +                                "desc": "The NYC Ranking"
  +                            },
  +                            {
  +                                "lang": "es",
  +                                "name": "NYC Rnk",
  +                                "desc": "El ranking de NY"
  +                            }
  +                        ]
  +                    },
  +                ]
  +            }
  +
  ++ Response 201
  +
  ++ Response 400 (application/json)
  +
  +        {
  +            "result": {
  +                "code": 400,
  +                "extended": {
  +                    [
  +                        {
  +                            "code": "E400-WRONG-PARAMETER",
  +                            "desc": "The parameter [param-name] was wrong"
  +                        }
  +                    ]
  +                }
  +            }
  +        }
  +
  ++ Response 500
  +
  +### Modifies the ranking definition [PATCH]
  +Allows to make change on the definition of the ranking. The modification can affect an existing data, or also can be 
  +the addition of a full definition for a new language or platform.
  +The data that define a ranking are the following:
  +
  +* **active**: if the ranking is active or not
  +* **properties**: a set of [properties] (#ranking_properties) that define the behaviour of the ranking
  +* **collection**: the [collection] (#ranking_collections) of the ranking
  +* **platforms**: the collection of [Platforms] (#platform_model) in which the ranking will be available. The "default" fields are not mandatory, if they are not specified the first element in the list will be considered the 'default'
  +
  ++ Parameters
  +    + rnk (string)... the id of the new ranking
  +
  ++ Request (application/json)
  +    + Body
  +        
  +            {
  +                    "active": false,
  +                    "platforms":[
  +                    {
  +                        "platform": "web",
  +                        "languages": [
  +                            {
  +                                "lang": "es",
  +                                "desc": "Ranking de Nueva York"
  +                            }
  +                        ]
  +                    },
  +                    {
  +                        "platform": "iphone",
  +                        "languages": [
  +                            {
  +                                "lang": "ru",
  +                                "name": "NYC Rnk",
  +                                "desc": "The NYC in Russian"
  +                            }
  +                        ]
  +                    },
  +                    {
  +                        "platform": "android",
  +                        "languages": [
  +                            {
  +                                "lang": "en",
  +                                "name": "NYC Rnk",
  +                                "desc": "The New York City Ranking"
  +                            }
  +                        ]
  +                    }
  +                ]
  +            }
  +
  ++ Response 200
  +
  ++ Response 400 (application/json)
  +
  +        {
  +            "result": {
  +                "code": 400,
  +                "extended": {
  +                    [
  +                        {
  +                            "code": "E400-WRONG-PARAMETER",
  +                            "desc": "The parameter [param-name] was wrong"
  +                        }
  +                    ]
  +                }
  +            }
  +        }
  +        
  ++ Response 404
  +
  ++ Response 500
  +
  +### Deletes a ranking [DELETE]
  +Deletes a ranking.
  +
  ++ Parameters
  +    + rnk (string)... the id of the ranking to be deleted
  +
  ++ Response 200
  +
  ++ Response 400 (application/json)
  +
  +        {
  +            "result": {
  +                "code": 400,
  +                "extended": {
  +                    [
  +                        {
  +                            "code": "E400-WRONG-PARAMETER",
  +                            "desc": "The parameter [param-name] was wrong"
  +                        }
  +                    ]
  +                }
  +            }
  +        }
  +
  ++ Response 404
  +
  ++ Response 500
  +
  +# Group Ranking Query & Member
  +
  +## Ranking Query [/rankings/{rnk}?top=7&bottom=9&platform=web]        
   ### Retrieves all the data related to a ranking [GET]
  -Returns all the information linked to a certain ranking.  
  +Returns all the information linked to a certain ranking.
  +Only **active** rankings can be queried.
   The returned data provide the following information:
   
  -**ranking**
  -
  -- rnk ... the id of the ranking
  -- name ... the name of the ranking
  -- desc ... a long description of the ranking
  -- members ... an aproximate number of users taken into account in the ranking
  -
  -**members**
  -
  -- mbr ... the id of the member
  -- pos ... the position of the member in the ranking
  -- score ... the score (points) of the member
  -- place ... an indication about whether the member belongs to the top (T) of the ranking or to the bottom (B)
  +* **ranking**: a [Ranking](#ranking_model) element
  +* **members**: a collection of [Member](#member_model) elements
   
   + Parameters
       + rnk (string)... the id of the ranking
       + top (long)... the first N members of the ranking
       + bottom (long) ... the last N members of the ranking
  +    + platform (string, optional) ... the id of one of the platforms available
   
   + Request
       + Headers
  
positive.code:             }
          }
  
  + Response 500
  
  ### Modifies the ranking definition [PATCH]
  Allows to make change on the definition of the ranking. The mofidification can affect an existing data, or also can be 
  the addition of full definition for a new language or platform.
  The data that define a ranking are the following:
  
  **platforms**
  
  - platform ... the id of the platform for which the definition is provided
  - languages ... the set of definitions provided for the ranking. At least one is required.
  
  -   lang ... the language for this definition
  -   name ... the name of the ranking (optional if the definition for the language already exists)
  -   desc ... a long description for the ranking (optional if the definition for the language already exists)
  
  + Parameters
      + rnk (string)... the id of the new ranking
  
  + Request (application/json)
      + Body
          
              {
                  "platforms":[
                      {
                          "platform": "web",
                          "languages": [
                              {
                                  "lang": "es",
                                  "desc": "Ranking de Nueva York"
                              }
                          ]
                      },
                      {
                          "platform": "iphone",
                          "languages": [
                              {
                                  "lang": "ru",
                                  "name": "NYC Rnk",
                                  "desc": "The NYC in Russian"
                              }
                          ]
                      },
                      {
                          "platform": "android",
                          "languages": [
                              {
                                  "lang": "en",
                                  "name": "NYC Rnk",
                                  "desc": "The New York City Ranking"
                              }
                          ]
                      }
                  ]
              }
  
  + Response 200
  
  + Response 400 (application/json)
  
          {
              "result": {
                  "code": 400,
                  "extended": {
                      [
                          {
                              "code": "E400-WRONG-PARAMETER",
                              "desc": "The parameter [param-name] was wrong"
                          }
                      ]
                  }
              }
          }
          
  + Response 404
  
  + Response 500
  
  ### Deletes a ranking [DELETE]
  Deletes a ranking.
  
  + Parameters
      + rnk (string)... the id of the ranking to be deleted
  
  + Response 200
  
  + Response 400 (application/json)
  
          {
              "result": {
                  "code": 400,
                  "extended": {
                      [
                          {
                              "code": "E400-WRONG-PARAMETER",
                              "desc": "The parameter [param-name] was wrong"
                          }
                      ]
                  }
              }
          }
  
  + Response 404
  
  + Response 500
  
  ## Ranking Member [/rankings/{rnk}/members/{mbr}]        
  ### Adds/Updates member information [PUT]
  Adds a new member to a ranking or updates the score of the member in the ranking.
  
  + Parameters
      + rnk (string)... the id of the ranking
      + mbr (string)... the id of the member
  
  + Request (application/json)
      + Body
  
              {
                  "score": 5678899
              }
  
  + Response 201
  
  + Response 400 (application/json)
  
  
negative.code:     + Body
  
              {
                  "score": 678999,
                  "collection": "cWorldDomination"
              }
              
  
  