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 個不重複 MD5	`HTTP 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 查詢常見問題。