Shared API Keys
Red has a central API key storage utilising the core bots config. This allows cog creators to add a single location to store API keys for their cogs which may be shared between other cogs.
There needs to be some consistency between cog creators when using shared API keys between cogs. To help make this easier service should be all lowercase and the key names should match the naming convention of the API being accessed.
Example:
Twitch has a client ID and client secret so a user should be asked to input
[p]set api twitch client_id,1234ksdjf client_secret,1234aldlfkd
and when accessed in the code it should be done by
await self.bot.get_shared_api_tokens("twitch")
Each service has its own dict of key, value pairs for each required key type. If there’s only one key required then a name for the key is still required for storing and accessing.
Example:
[p]set api youtube api_key,1234ksdjf
and when accessed in the code it should be done by
await self.bot.get_shared_api_tokens("youtube")
Basic Usage
class MyCog:
@commands.command()
async def youtube(self, ctx, user: str):
youtube_keys = await self.bot.get_shared_api_tokens("youtube")
if youtube_keys.get("api_key") is None:
return await ctx.send("The YouTube API key has not been set.")
# Use the API key to access content as you normally would
Event Reference
Additional References
- await Red.get_shared_api_tokens(service_name=None)[source]
Gets the shared API tokens for a service, or all of them if no argument specified.
- Parameters:
service_name (str, optional) – The service to get tokens for. Leave empty to get tokens for all services.
- Returns:
A Mapping of token names to tokens. This mapping exists because some services have multiple tokens. If
service_name
isNone
, this method will return a mapping with mappings for all services.- Return type:
- await Red.set_shared_api_tokens(service_name, **tokens)[source]
Sets shared API tokens for a service
In most cases, this should not be used. Users should instead be using the
set api
commandThis will not clear existing values not specified.
- Parameters:
service_name (str) – The service to set tokens for
**tokens – token_name -> token
Examples
Setting the api_key for youtube from a value in a variable
my_key
>>> await ctx.bot.set_shared_api_tokens("youtube", api_key=my_key)
- await Red.remove_shared_api_tokens(service_name, *token_names)[source]
Removes shared API tokens
- Parameters:
Examples
Removing the api_key for youtube
>>> await ctx.bot.remove_shared_api_tokens("youtube", "api_key")