Hướng dẫn sử dụng API (B2B)

API cho phép tra cứu IMEI nhà mạng Nhật, Samsung và mở khoá Softbank tự động. Liên hệ admin để được cấp API key (gắn nhãn theo doanh nghiệp).

1. Tổng quan

Base URL:

https://dtcenter.net/api/v3

Mọi request là GET, trả về JSON dạng { "message": "<kết quả>" }.

Dịch vụEndpointVí dụ kết quả
AU/au/:imei○ / × / -
SoftBank (check)/sb/:imei○ / × / △
Docomo/docomo/:imei○ / × / -
Mineo/mineo/:imei○ / ×
Rakuten/rakuten/:imei○ / ×
Samsung/samsung/:imeiModel + thông tin
Unlock Softbank/softbank/:imeiTrạng thái mở khoá

2. Xác thực bằng API key

Gửi key qua header X-API-Key trong mỗi request:

X-API-Key: dtk_xxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Không nhúng key vào web/app phía client công khai. Mỗi lượt gọi được ghi log theo key + IP.

3. Gọi bằng fetch (JavaScript)

const res = await fetch(
  "https://dtcenter.net/api/v3/au/356789012345678",
  { headers: { "X-API-Key": "dtk_xxxxxxxxxxxxxxxxxxxxxxxx" } }
);
const data = await res.json();
console.log(data.message); // ví dụ: "○"

4. Mẫu kết quả trả về

// Thành công (HTTP 200)
{ "message": "○" }

// Samsung (HTTP 200)
{ "message": "SM-S911B / Galaxy S23 / ..." }

// IMEI sai (HTTP 400)
{ "message": "IMEI Error" }

// Lỗi hệ thống (HTTP 500)
{ "message": "error" }

5. Dùng bằng cURL (shell)

curl -H "X-API-Key: dtk_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://dtcenter.net/api/v3/sb/356789012345678"

6. Áp dụng vào Excel

6.1 Power Query (Data → Get Data → Blank Query → Advanced Editor)

let
  imei = "356789012345678",
  url  = "https://dtcenter.net/api/v3/au/" & imei,
  json = Json.Document(
    Web.Contents(url, [Headers=[#"X-API-Key"="dtk_xxxxxxxxxxxxxxxxxxxxxxxx"]])
  )
in
  json[message]

6.2 Hàm tự tạo bằng VBA (Alt+F11 → Module)

Function CheckImei(imei As String, Optional carrier As String = "au") As String
    Dim http As Object, s As String
    Set http = CreateObject("MSXML2.XMLHTTP")
    http.Open "GET", "https://dtcenter.net/api/v3/" & carrier & "/" & imei, False
    http.setRequestHeader "X-API-Key", "dtk_xxxxxxxxxxxxxxxxxxxxxxxx"
    http.send
    s = http.responseText                 ' {"message":"..."}
    CheckImei = Mid(s, InStr(s, ":""") + 2, InStrRev(s, """") - InStr(s, ":""") - 2)
End Function

Dùng trong ô: =CheckImei(A2) hoặc =CheckImei(A2,"sb")

7. Áp dụng vào Google Sheets

Mở Extensions → Apps Script, dán đoạn sau rồi lưu:

function CHECKIMEI(imei, carrier) {
  carrier = carrier || "au";
  var url = "https://dtcenter.net/api/v3/" + carrier + "/" + imei;
  var res = UrlFetchApp.fetch(url, {
    headers: { "X-API-Key": "dtk_xxxxxxxxxxxxxxxxxxxxxxxx" },
    muteHttpExceptions: true
  });
  return JSON.parse(res.getContentText()).message;
}

Dùng trong ô: =CHECKIMEI(A2) hoặc =CHECKIMEI(A2,"docomo")

Lưu ý: tên hàm tuỳ chỉnh phải viết HOA khi gọi trong ô (ràng buộc của Google Sheets).

8. Mã trạng thái HTTP

MãÝ nghĩa
200Thành công — đọc message
400IMEI không hợp lệ
500Lỗi crawl / hệ thống — thử lại sau

Key tuỳ chọn: request không key vẫn chạy nhưng không được gắn thống kê theo doanh nghiệp.

arrow_upward