如何开始使用 MaxMind 开发者门户中的 API 和数据库?
MaxMind 开发者门户（dev.maxmind.com）是接入其 IP 情报与风险评分服务的入口，主要分两条产品线：minFraud Web Services（交易风险评分）和 GeoIP / GeoLite（IP 地理位置与网络属性）。如果你的目标是识别高风险交易，从 minFraud 入手；如果目标是按 IP 做内容定制、合规判断或安全分析，从 GeoIP / GeoLite 入手。两者都提供快速入门（Quickstart）和 API 文档，minFraud 另有沙盒环境可用于测试。
先分清两条产品线
| 维度 | minFraud Web Services | GeoIP / GeoLite |
|---|---|---|
| 核心用途 | 交易风险评分与风险数据，识别电商支付、平台用户活动、激励流量等场景中的高风险行为 | IP 地理位置与网络情报，用于内容定制、广告、数字版权管理、合规、欺诈检测、安全等 |
| 主要形态 | Web 服务（Transaction Risk API 等） | 数据库（Databases）与 Web 服务（Web Services），另有客户端 JavaScript |
| 测试方式 | 提供 MaxMind Sandbox 用于测试 minFraud | 文档中列出 Sandbox Environment |
| 免费获取 | 未见免费说明 | 可注册 GeoLite 账号获取免费 IP 地理定位数据 |
接入 minFraud Web Services
minFraud 的核心是 Transaction Risk API：提交一笔交易，获得风险评分和相关数据，用来判断该活动是否高风险。
- 阅读概览：先看 minFraud Overview，了解可评估的对象和整体流程。
- 走快速入门：从 Quickstart 入手，按文档完成首次调用。
- 评估交易：使用 Transaction Risk API 对交易进行风险评分。
- 回传结果：通过 Report a transaction 上报交易结果，用于后续改进。
- 在沙盒中测试：用 MaxMind Sandbox 测试 minFraud，避免直接影响生产判断。
- 查 API 文档：Requests / Responses 说明请求与响应结构；如涉及旧接口，可参考 minFraud Legacy 与 Proxy Detection Legacy Web Service。
- 跟踪变更：关注 minFraud Release Notes，避免接口行为变化影响集成。
相关能力还包括 Track Devices（含 Web、Android、iOS）和 minFraud Alerts，以及 Working with Transaction Dispositions 这类交易处置说明。
接入 GeoIP 与 GeoLite
GeoIP 用于获取 IP 的地理与网络属性，GeoLite 是其可免费注册获取的数据版本。
- 阅读概览：从 GeoIP Overview 开始，明确你要做的是地理定位还是网络属性判断。
- 选择形态：
- 需要本地查询：使用 Databases，并参考 Updating Databases 保持数据更新。
- 需要在线查询：使用 Web Services，参考 Web Services Documentation 的 Requests / Responses。
- 需要在浏览器端判断：使用 Client-side Javascript。
- 导入数据库：如需入库查询，可按文档导入 PostgreSQL 或 MySQL。
- 按需选数据维度：数据库文档覆盖 City and Country、Enterprise、Anonymous IP、Anonymous Plus、Residential Proxy、ISP、Connection Type、Domain、ASN、Static IP Score、User Count 等。
- 免费起步：注册 GeoLite 账号即可获取免费 IP 地理定位数据；GeoLite Databases and Web Services 是对应入口。
- 跟踪变更：关注 GeoIP Release Notes 和 Track Location Name Updates。
通用配套资源
无论走哪条线，这些资源都会用到：
- MaxMind Server IP Addresses：确认服务端 IP 范围。
- License Key Validation API：校验许可密钥。
- MMDB Format Spec：数据库文件格式规范。
- OpenAPI Specs：接口规范文件。
- Knowledge Base：常见问题与操作说明。
- Contribute：参与贡献的入口。
常见卡点
- 测试环境用错：minFraud 有 Sandbox，正式判断前先在沙盒验证请求与响应，避免把测试数据混入生产。
- 数据库忘记更新：使用 Databases 时需按 Updating Databases 定期更新，否则地理与网络属性会过时。
- 接口版本混淆：文档中同时存在当前接口与 Legacy 接口（如 minFraud Legacy、Legacy Web Services），集成前确认自己用的是哪一套。
- 免费范围误解：GeoLite 可注册免费账号获取数据；minFraud 的定价与登录限制在现有资料中未说明，接入前需自行确认账号与授权条件。