V4 Marketing API
HomeAPI ReferenceChangelog
HomeAPI ReferenceChangelog
V4 Marketing
  1. Home
  • Introdução
  • Autenticação
  • Limites e Boas Práticas
  • Sincronização e Atualização de Dados
  1. Home

Autenticação

Como Obter seu Token#

1.
Acesse v4marketing.mktlab.app
2.
Faça login utilizando o SSO da V4Company
3.
Navegue até a página API de Dados
4.
Clique em "Gerar Token"
5.
O token será automaticamente copiado para sua área de transferência

Usando o Token#

Inclua o token em todas as requisições no cabeçalho HTTP:

Exemplo de Requisição#

Parâmetro Obrigatório: workspaceId#

Todas as requisições exigem o parâmetro workspaceId para identificar o workspace.

Características#

Deve ser enviado como query parameter em cada requisição
É obrigatório em todas as chamadas
Requisições sem workspaceId retornarão erro de validação

Exemplo#

GET https://api.data.v4.marketing/endpoint?workspaceId=seu_workspace_id&limit=100

Segurança#

Mantenha seu token seguro: Nunca compartilhe ou exponha publicamente
Não versione tokens: Nunca commite tokens em repositórios de código
Use variáveis de ambiente: Armazene tokens em variáveis de ambiente
Rotação de tokens: Gere novos tokens periodicamente
Revogação: Se um token for comprometido, gere um novo imediatamente

Erros de Autenticação#

Token Ausente, Malformado ou Inválido#

workspaceId Ausente#

Modificado em 2025-10-31 13:59:42
Página anterior
Introdução
Próxima página
Limites e Boas Práticas
Built with