MaxMind 开发者门户:API 文档、规范与知识库入口
MaxMind 的 API 文档、OpenAPI 规范、MMDB 格式规范和知识库都集中在开发者门户 dev.maxmind.com 上。门户首页把入口分成两条主线：minFraud Web Services（交易风险评分）和 GeoIP / GeoLite（IP 地理位置与网络情报）。如果你要找的是某个具体接口的请求/响应字段，走对应产品的 API Documentation；如果要看机器可读的接口定义或数据库文件格式，走 OpenAPI Specs 和 MMDB Format Spec；如果是要排查集成问题或查更新记录，走 Knowledge Base 和 Release Notes。
minFraud 相关文档入口
minFraud 是交易风险评分服务，门户首页给出的入口包括：
- minFraud Overview：产品总览
- Evaluate a Transaction / Report a transaction：交易评估与上报
- Track Devices（Web、Android、iOS）：设备追踪
- minFraud Alerts：告警
- Working with Transaction Dispositions：交易处置结果的处理
- Testing minFraud in the MaxMind Sandbox：沙箱测试
- API Documentation（Requests / Responses）：接口请求与响应说明
- minFraud Legacy：旧版接口
- Proxy Detection Legacy Web Service：旧版代理检测服务
- minFraud Release Notes：版本更新记录
需要评估一笔交易时，先看 Evaluate a Transaction 了解输入字段，再看 API Documentation 的 Requests/Responses 确认返回结构；正式接入前用 Sandbox 环境验证，避免用生产数据试错。
GeoIP 与 GeoLite 相关文档入口
GeoIP 和 GeoLite 覆盖数据库和 Web 服务两种交付方式，门户列出的入口包括：
- Geolocate an IP：单 IP 查询
- Databases / Web Services：数据库与 Web 服务两种形态
- Client-side Javascript：浏览器端调用
- Updating Databases：数据库更新
- Track Location Name Updates：地名变更跟踪
- Importing Databases：导入数据库，含 Import to PostgreSQL 和 Import to MySQL
- Web Services Documentation（Requests / Responses / Sandbox Environment）
- Legacy Web Services：旧版 Web 服务
- Database Documentation：数据库字段文档，按产品分列，包括 City and Country、Enterprise、Anonymous IP、Anonymous Plus、Residential Proxy、ISP、Connection Type、Domain、ASN、Static IP Score、User Count
- GeoLite Databases and Web Services：免费版本
- GeoIP Exchange、Privacy Exclusions API、GeoIP Release Notes
选型时先确定用数据库还是 Web 服务：数据库适合本地高频查询、需要自行控制更新节奏的场景；Web 服务适合不想维护本地文件、按请求调用的场景。字段差异看 Database Documentation 下对应产品的页面，不要假设所有产品字段一致。
规范与格式文档
门户单独列出了两类规范：
- MMDB Format Spec：MaxMind 数据库文件（.mmdb）的二进制格式规范。需要自己解析数据库文件、或验证第三方读取库是否正确时看这里。
- OpenAPI Specs：接口的机器可读定义。用于生成客户端代码、导入 Postman/Apifox 等工具，或核对字段类型。
知识库、贡献与其他入口
- Knowledge Base：集成与使用问题的排查入口。
- Contribute：贡献渠道。
- MaxMind Server IP Addresses：MaxMind 服务器 IP 列表，配置防火墙白名单时需要。
- License Key Validation API：许可证密钥校验接口。
按需求找入口的对照
| 你要做的事 | 入口 |
|---|---|
| 查 minFraud 接口字段 | minFraud → API Documentation（Requests / Responses） |
| 测试 minFraud 集成 | Testing minFraud in the MaxMind Sandbox |
| 查 GeoIP 数据库字段 | GeoIP → Database Documentation → 对应产品 |
| 查 GeoIP Web 服务调用方式 | GeoIP → Web Services Documentation |
| 自己解析 .mmdb 文件 | MMDB Format Spec |
| 生成客户端代码或导入 API 工具 | OpenAPI Specs |
| 看版本变更 | minFraud Release Notes / GeoIP Release Notes |
| 排查集成问题 | Knowledge Base |
| 配置服务器白名单 | MaxMind Server IP Addresses |
GeoLite 账号可以注册获取免费的 IP 地理位置数据，具体覆盖范围和字段以 GeoLite Databases and Web Services 页面为准。