API & Desenvolvedores
2 min de leituraAtualizado em 22 out. de 2026

Autenticação

Crie e proteja chaves de integração com escopos por operação.

Abrir no app

Antes de começar

  • A contratação deve permitir API e sua função deve autorizar criar chaves. Integre pelo seu sistema seguro, sem expor a chave no navegador público.

Como usar

  1. Em API e SDK, crie uma chave com os acessos necessários e guarde o valor com segurança.
  2. Use Authorization: Bearer no cliente servidor, conforme a referência.
  3. Para 401, confira validade da chave; para 403, confira escopos e acesso à conta/recurso. Revogue uma chave exposta.
http
1Authorization: Bearer wcp_sua_chave
2Content-Type: application/json

Defina nome, permissões e validade

  • Em API e SDK, identifique a chave por finalidade, selecione permissões e confira expiração quando oferecida. Guarde o valor com segurança.
  • Use Authorization: Bearer conforme a operação. Para 401, confira credencial e validade; para 403, confira autorização do módulo, escopo e conta.
  • Se a chave vazar, revogue e substitua nos consumidores autorizados. Não envie o valor em suporte ou no endereço da requisição.

Como conferir o resultado

  • Uma leitura autorizada funciona e uma operação fora do escopo é recusada.

Limites e cuidados

  • Não inclua chave em URL, frontend público, repositório ou print. Separe testes de produção.

Se algo não funcionar

Uma leitura funciona e uma escrita falha
Confira a permissão específica de escrita e os requisitos da operação. Autenticar não concede todos os escopos.

Continuar no aplicativo

Este artigo resolveu sua dúvida?

Sua avaliação ajuda a priorizar revisões de conteúdo.