Chaves de API
A API REST do Pliic é autenticada com chaves secretas (sk_live_…), uma por app. Cada chave carrega um conjunto de escopos que limitam o que ela pode acessar.
A API está disponível nos planos Starter e Pro. O plano Gratuito não inclui este recurso.
Onde gerenciar
Seção intitulada “Onde gerenciar”Acesse Configurações → Chaves de API. A página lista cada app da equipe com a sua chave secreta, os escopos atuais, o último uso e o status (ativa ou revogada).
Apenas membros com papel Administrador ou Dono podem visualizar e gerenciar as chaves de API.
Escopos
Seção intitulada “Escopos”Os escopos definem quais partes da API a chave pode usar:
| Escopo | Permite |
|---|---|
suggestions:read | Ler sugestões |
suggestions:write | Criar e atualizar sugestões |
tickets:read | Ler tickets de suporte |
tickets:write | Criar e atualizar tickets |
analytics:read | Ler dados de analytics |
privacy:read | Exportar dados de privacidade do usuário |
privacy:write | Excluir dados de privacidade do usuário |
Selecione Acesso total para conceder todos os escopos atuais e futuros.
Rotacionar uma chave
Seção intitulada “Rotacionar uma chave”Em Ações da chave → Rotacionar chave, uma nova chave secreta é gerada e exibida uma única vez. Os escopos são preservados, mas a chave antiga deixa de funcionar imediatamente. Atualize suas integrações com o novo valor antes de fechar o aviso.
Revogar e restaurar
Seção intitulada “Revogar e restaurar”Revogar desativa a chave imediatamente: qualquer requisição passa a retornar 401. Use Restaurar para reativá-la. A chave secreta em si não muda ao revogar/restaurar.
Referência da API
Seção intitulada “Referência da API”O botão Referência da API abre a documentação interativa (OpenAPI) com todos os endpoints, parâmetros e exemplos. A especificação também está disponível publicamente em /api/v1/openapi.json.