Clickfin

Referência da API
Portal oficial
GET/market-segment

Listar todos os segmentos de mercado da empresa

Retorna uma lista hierárquica de segmentos de mercado não excluídos associados à companyId do usuário autenticado. A lista é estruturada com segmentos principais e seus respectivos subsegmentos aninhados. Requer perfil de Administrador.

AcessoChave de API · market_segments:read
Parâmetros0
Respostas5

Respostas

200Sucesso

Lista de segmentos retornada com sucesso.

401Erro

Token ausente, inválido ou sem empresa selecionada.

403Erro

Falha de autorização.

429Erro

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.

503Erro

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.