Clickfin

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

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.

AcessoChave de API · market_segments:write
Parâmetros0
Respostas7

Respostas

201Sucesso

Segmento de mercado criado com sucesso.

400Erro

Erro de validação ou de regra de negócio.

401Erro

Token ausente, inválido ou sem empresa selecionada.

403Erro

Falha de autorização.

404Erro

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).

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.