CleanTalk API 方法

本文介绍 CleanTalk 提供的公共 API 方法，用于垃圾信息和机器人检测、访问黑名单数据库以及客户数据管理。

我们的云端每天处理海量数据以识别垃圾信息发送者，这些能力可通过多种 API 方法供您调用。

实时垃圾信息检测方法

我们提供 5 种核心的垃圾信息和机器人检测方法，它们运行速度快，因此建议在实时场景中使用。

所有这些方法的统一调用入口是我们的审核服务器池：https://moderate.cleantalk.org/api2.0 除非另有说明。

垃圾信息和机器人检测方法

• check_message -  用于过滤评论、评价或联系表单等包含用户生成内容（UGC）的表单中的垃圾信息。
• check_newuser -  用于过滤垃圾注册、投票和电商订单中的垃圾信息。
• check_bot - 用于在普通页面浏览过程中于后台过滤机器人。

辅助方法

• frontend_data - 用于在后台收集网站访客数据，以提升上述方法的效果。
• send_feedback - 用于将您的人工审核结果发送至 CleanTalk 云端，以改进垃圾/非垃圾信息的学习效果。

附加方法

此外还有许多附加方法，它们让您能够访问我们的云端数据库，并对您的私有列表和设置进行管理。

所有这些方法的统一调用入口是我们的 API 服务器池：https://api.cleantalk.org

黑名单数据库访问方法

这些方法用于从我们的数据库中获取各类数据。

• spam_check - 用于获取 IP 地址或电子邮箱在我们黑名单数据库中长期以来的状态信息。
• spam_check_cms - 上述方法的 CMS 版本。
• ip_info - 用于获取 IP 地址所属的国家代码。

私有列表管理方法

这些方法用于操作我们 Anti-Spam 和 Security 产品的私有列表。

• private_list_add - 用于在您的私有列表中添加一条记录。
• private_list_get - 用于获取记录列表。
• private_list_update - 用于更新一条记录。
• private_list_delete - 用于删除一条记录。

站点监控管理方法

这些方法用于操作我们 Site Monitoring 产品中的项目。

• monitoring_services_add - 用于添加一个待监控的站点。
• monitoring_services_get - 用于获取站点列表。
• monitoring_services_update - 用于更新一个站点。
• monitoring_services_delete - 用于删除一个站点。

设置模板管理方法

这些方法用于操作您本地站点设置的模板。

• services_templates_add - 用于添加一个模板。
• services_templates_get - 用于获取模板列表。
• services_templates_update - 用于更新一个模板。
• services_templates_delete - 用于删除一个模板。
• services_templates_set - 用于设置一个模板。