Documentação do Steamworks
Autenticação com chaves da Web API
Alguns métodos da Web API retornam dados acessíveis ao público e não requerem autorização quando são chamados. Outros métodos podem requerer a utilização de uma chave única da API. Existem também métodos que retornam dados delicados ou que realizam uma ação protegida, exigindo permissões especiais de acesso. Estes métodos requerem uma chave de editora, a qual terá de criar antes de os usar. Nos casos onde é obrigatório usar uma chave da API, esta pode ser fornecida como um parâmetro padrão ou como o valor do cabeçalho "x-webapi-key" do pedido.

Chaves de utilizador

As chaves comuns de utilizador estão disponíveis para todos; basta apenas uma conta Steam e o nome do domínio que será associado a esta chave.

Também será necessário aceitar os termos de utilização da Web API do Steam.

Pode criar uma chave de utilizador da Web API a partir desta página.

Chaves de editora

Para identificar uma editora de forma segura e permitir o acesso a métodos protegidos, uma editora pode solicitar uma chave da Web API que pode ser passada no parâmetro "key" dos métodos apropriados. Cada chave é associada a um grupo de editora e pode ser usada para aceder aos dados de todos os AppIDs associados a esse grupo. Para receber uma chave da Web API de editora, consulte a secção "Criação de uma chave da Web API de editora" abaixo.

Chaves da Web API de editora permitem o acesso a dados delicados de utilizadores e métodos protegidos. Estas chaves devem ser usadas para pedidos à Web API originárias de servidores protegidos da editora. As chaves devem ser guardadas num local seguro e não devem ser distribuídas na aplicação. Todos os pedidos à Web API que contenham chaves da Web API devem ser efetuados por HTTPS.

Criação de uma chave da Web API de editora

Para criar uma chave da Web API de editora, irá precisar de permissões de administrador numa conta Steamworks existente. Se não tiver permissões de administrador, uma lista de administradores da sua conta de parceiro está disponível no lado direito da página inicial do Steamworks. Qualquer um destes administradores pode criar a sua chave da Web API de editora ou conceder-lhe permissões de administrador.

Para criar uma chave da Web API de editora:
  1. Enquanto utilizador com permissões de administrador na sua conta Steamworks, aceda à sua lista de grupos em "Utilizadores e permissões" -> "Gerir grupos".
  2. A partir da lista de grupos, selecione ou crie um grupo que contenha os AppIDs aos quais pretende que a chave da Web API tenha acesso.
  3. Clique nesse grupo para ver os respetivos utilizadores e aplicações.
  4. Se tiver permissões de administrador, poderá ver a opção para "Criar chave da Web API" no lado direito da página ou poderá ver a chave listada, caso já tenha sido criada.