Métodos da API CleanTalk

Este artigo descreve os métodos públicos da API CleanTalk para verificação de spam e bots, acesso ao banco de dados de blacklist e manipulação de dados de clientes.

Nossa nuvem processa uma grande quantidade de dados para reconhecer spammers, e essa funcionalidade está disponível para você por meio de vários métodos de API.

Métodos de verificação de spam em tempo real

Existem 5 métodos principais de verificação de spam e bots; eles são rápidos, por isso é recomendado utilizá-los em tempo real.

O ponto único de chamada para todos esses métodos é o nosso pool de servidores de moderação: https://moderate.cleantalk.org/api2.0 salvo indicação em contrário.

Métodos de verificação de spam e bots

• check_message -  para filtrar spam em formulários que contêm conteúdo gerado pelo usuário (UGC), como comentários, avaliações ou formulários de contato.
• check_newuser -  para filtrar cadastros, enquetes e pedidos de e-commerce que sejam spam.
• check_bot - para filtrar bots em segundo plano durante a simples visualização da página.

Métodos de apoio

• frontend_data - para coletar dados do visitante do site em segundo plano, melhorando o funcionamento dos métodos anteriores.
• send_feedback - para enviar o resultado da sua moderação manual à nuvem CleanTalk, aprimorando o aprendizado de spam/não spam.

Métodos auxiliares

Existem muitos métodos auxiliares. Eles fornecem acesso aos nossos bancos de dados na nuvem e dão a você controle sobre suas listas privadas e configurações.

O ponto único de chamada para todos esses métodos é o nosso pool de servidores de API: https://api.cleantalk.org

Métodos de acesso ao banco de dados de blacklist

Esses métodos têm como objetivo obter diversos dados dos nossos bancos de dados.

• spam_check - para obter informações sobre o status de um endereço IP ou e-mail em nosso banco de dados de blacklist por um longo período de tempo.
• spam_check_cms - versão do método anterior voltada para CMS.
• ip_info - para obter o código do país de um endereço IP.

Métodos de controle de listas privadas

Esses métodos têm como objetivo operar com as listas privadas dos nossos produtos Anti-Spam e Security.

• private_list_add - para adicionar um registro à sua lista privada.
• private_list_get - para obter uma lista de registros.
• private_list_update - para atualizar um registro.
• private_list_delete - para excluir um registro.

Métodos de controle de monitoramento de sites

Esses métodos têm como objetivo operar com itens do nosso produto Site Monitoring.

• monitoring_services_add - para adicionar um site para monitoramento.
• monitoring_services_get - para obter sites.
• monitoring_services_update - para atualizar um site.
• monitoring_services_delete - para excluir um site.

Métodos de controle de modelos de configuração

Esses métodos têm como objetivo operar com modelos das configurações locais dos seus sites.

• services_templates_add - para adicionar um modelo.
• services_templates_get - para obter modelos.
• services_templates_update - para atualizar um modelo.
• services_templates_delete - para excluir um modelo.
• services_templates_set - para definir um modelo.