FMD5

MD5 查询 API 接入文档

使用 FMD5 API 一次查询最多 100 个不重复 MD5。接口通过 API Key 鉴权，只返回命中的候选原文，每个不重复 MD5 消耗一个查询额度。

接口地址
GET https://www.fmd5.com/api/query?key=YOUR_API_KEY&md5s=HASH_1,HASH_2

快速开始

注册并登录控制台，在 API Key 页面获取密钥。提交的 MD5 必须是 32 位十六进制字符串，多个值使用英文逗号分隔。

curl --get 'https://www.fmd5.com/api/query' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'md5s=202cb962ac59075b964b07152d234b70,81dc9bdb52d04dc20036dbd8313ed055'

成功返回

请求成功时返回 code: 0。result 只包含已命中的 MD5；合法 MD5 没有出现在对象中，表示当前数据集未查询到对应值。

{
  "code": 0,
  "result": {
    "202cb962ac59075b964b07152d234b70": "123",
    "81dc9bdb52d04dc20036dbd8313ed055": "1234"
  }
}

限制与错误处理

情况响应客户端处理
查询成功HTTP 200，code: 0读取 result 中的命中值。
账户余额或子 Key 配额不足HTTP 200，code: -1停止请求，充值或增加子 Key 配额。
超过 100 个不重复 MD5HTTP 400，QUERY_LIMIT_EXCEEDED先去重，再按每批 100 个拆分。
MD5 格式错误HTTP 400，INVALID_MD5只保留 32 位十六进制字符串。
API Key 无效HTTP 401，INVALID_API_KEY确认密钥有效且未被变更或停用。
请求频率过高HTTP 429，RATE_LIMIT_EXCEEDED按 Retry-After 等待后串行重试。

推荐批量策略

先将 MD5 转为小写并去重，再拆分为每批最多 100 个。客户端必须单线程串行调用，每次请求至少间隔一秒；并发或多线程高频请求可能触发 IP 防护。

遍历每批最多 100 个不重复 MD5：
  发起查询
  如果返回 HTTP 429：
    按 Retry-After 等待并重试当前批次
  否则保存 result
  至少等待 1 秒后再请求下一批

API Key 安全

接口采用 GET 请求，API Key 可能出现在应用、代理或浏览器历史日志中。请从受控服务端调用，始终使用 HTTPS，并在日志中脱敏 key 参数。不要把真实密钥写入前端 JavaScript、公开仓库或文档。

建议为不同项目创建独立子 API Key 并设置配额。密钥泄露后应立即停用或变更。不要提交密码、私钥、身份资料或无权处理的数据。

查询结果的语义

MD5 是单向摘要而不是可逆加密。返回值是与所提交摘要匹配的候选原文；未命中只表示当前数据集没有映射。重要业务使用前应在本地重新计算 MD5 校验。盐值 MD5、碰撞和安全限制请阅读 MD5 查询常见问题。