Criar um novo segmento de mercado
Cria um novo segmento de mercado vinculado à empresa do usuário autenticado. - Para criar um segmento principal, envie isMain: true e não envie parentId. - Para criar um subsegmento, envie isMain: false e o parentId do segmento principal correspondente. Requer perfil de Administrador.
market_segments:writeRespostas
Segmento de mercado criado com sucesso.
Erro de validação ou de regra de negócio.
Token ausente, inválido ou sem empresa selecionada.
Falha de autorização.
Segmento pai não encontrado (inexistente, excluído, de outra empresa ou de outro licenciado), ou empresa da sessão excluída/fora do licenciado no momento da gravação (MARKET_SEGMENT.CREATE.NOT_AUTHORIZED com status 404, mantido por compatibilidade).
Limite de requisições excedido (RATE_LIMIT.EXCEEDED). Por chave: 120 requisições por minuto (janela fixa de 60 s); o 429 da chave traz X-RateLimit-* da chave. Por IP, para tráfego com chave: 600 requisições em 10 minutos; esse 429 traz só Retry-After, sem X-RateLimit-* (os cabeçalhos descrevem apenas o limite da chave). Aguarde Retry-After segundos antes de tentar de novo.
Credencial não pôde ser verificada por falha temporária do servidor (AUTH.SESSION_UNAVAILABLE). Não invalida a chave nem a sessão: repita com backoff.