Affected:
https://api.tlopo.com/news/feed/
https://api.tlopo.com/releases/feed/

Requests with a specified number of entries ".../feed/10" does not give expected result. News feed will return all news for whatever integer provided. Releases gives a 500 error for any integer provided. Both give correct results when given no integer.

The API documentation does not provide any information on downloads, yet provides information on logging in which seems to be an oversight/omission. It seems that download requests are done through download.tlopo.com rather than through the API. I'm unsure if there were plans to include API requests for downloading through the API as well, if so maybe that's the reason for the omission.

Regardless, including the relevant download documentation for downloading/updating the game in the API docs would be beneficial.

As a consumer of the TLOPO API I would like the ability to retrieve a population breakdown by location for any given shard.

Use case:
A user is switching servers to sail on a less populated server. This information will help inform their decision and prevent switching to an ocean where the majority of the population is sailing.

Example:

GET <api>/shards/<shard_id>

{
  "locations": [
    {
      "location_id": 123,
      "location_name": "Tortuga",
      "population": 12
    }, ...
  ]
}

If you were willing to expose player information as well that could be included in this endpoint.

GET <api>/shards/<shard_id>

{
  "locations": [
    {
      "location_id": 123,
      "location_name": "Tortuga",
      "players": [
        {
          "player_id": 123,
          "player_name": "John",
          "guild_id": 456,
          "guild_name": "Some Guild",
          ...
        }, ...
      ]
    }, ...
  ]
}

Without knowing the underlying architecture I can't advocate for a specific format, but I would prefer to receive more information up front versus making numerous requests per resource.

The Ocean API Ocean Information section has several incomplete fields. The Fleet subsection is mostly complete, but lacks helpful documentation on the fields Type and State. The Invasions subsection still mentions that the feature is under development. Invasions are now part of the game, but there has not been an update to this API/documentation. Please provide more detail in these sections as possible.