Response Caching

Response Caching is Corkus.py functionality that speeds up your application and decrees load on the API. It’s completely automated background process that is enabled by default.

Response caching time

The time for which Corkus caches responses is purely bases on Cache-Control header sent by the API. Header is provided for most of the endpoints, if not, it defaults to 10 minutes.

Important

Caching times are regulated by API administrators and are subject to change independently of Corkus.py.

Current cache times are decided intro 3 groups:

Short Cache 30 seconds:

This group is designated for most rapidly changing endpoints.

• GuildEndpoint.list_all()

• GuildEndpoint.get()

• TerritoryEndpoint.list_all()

• NetworkEndpoint.players_sum()

• NetworkEndpoint.online_players()

• SearchEndpoint.guilds_and_players()

• PlayerEndpoint.search()

• GuildEndpoint.search()

• LeaderboardEndpoint.guild()

• LeaderboardEndpoint.combat()

• LeaderboardEndpoint.pvp()

Medium Cache 10 minutes:

This group is designated for less active endpoints that still update sometimes.

• PlayerEndpoint.get()

• PlayerEndpoint.get_uuid()

• IngredientEndpoint.list_all()

• RecipeEndpoint.list_all()

Long Cache 60 minutes:

This group is designated for mostly static endpoints that change only on updates.

• IngredientEndpoint.get()

• RecipeEndpoint.get_by_id()