Clickfin

Referência da API
Portal oficial
GET/supplier

Listar fornecedores

AcessoChave de API · suppliers:read
Parâmetros8
Respostas6

Parâmetros

  • cpfCnpjquery

    Sem descrição disponível.

  • namequery

    Sem descrição disponível.

  • tradeNamequery

    Sem descrição disponível.

  • emailquery

    Sem descrição disponível.

  • statusquery

    Sem descrição disponível.

  • marketSegmentquery

    Sem descrição disponível.

  • pagequery

    Sem descrição disponível.

  • limitquery

    Sem descrição disponível.

Respostas

200Sucesso

Fornecedores paginados.

400Erro

Campo inválido, incluindo identificador inválido.

401Erro

Token ausente, inválido ou expirado. Em criação, atualização e exclusão, também é retornado quando a empresa da sessão foi excluída ou deixou de pertencer ao licenciado no momento da gravação (SUPPLIER.CREATE.NOT_AUTHORIZED, SUPPLIER.UPDATE.NOT_AUTHORIZED, SUPPLIER.DELETE.NOT_AUTHORIZED).

403Erro

A operação foi bloqueada pelas regras comerciais ou pelo perfil do usuário.

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.