Dữ liệu Việt Nam vn/numbering/check

Kiểm tra và chuẩn hoá một số thuê bao di động Việt Nam

Nhận cả ba cách viết (`0912345678`, `84912345678`, `+84912345678`) và trả về đủ ba dạng cùng với mã mạng và phần số thuê bao. Số sai định dạng vẫn trả về mã 200 kèm `hop_le: false` và lý do cụ thể, vì đây là công cụ kiểm đầu vào của người dùng cuối. GIỚI HẠN QUAN TRỌNG: endpoint này KHÔNG cho biết số thuộc nhà mạng nào. Chuyển mạng giữ số có hiệu lực từ 16/11/2018 và mở rộng toàn bộ từ 01/01/2019, nên mã mạng chỉ cho biết đơn vị nào được cấp dải số chứ không cho biết đơn vị nào đang phục vụ thuê bao — vì vậy trường trả về tên là `don_vi_duoc_cap_ma`, không phải `nha_mang`.

GET https://api-tools.hitechcloud.vn/api/vn/numbering/check Đã chép

Cần khoá API

Tham số

phone string · truy vấn bắt buộc

Số thuê bao cần kiểm. Nhận 0912345678, 84912345678 hoặc +84912345678. Dấu cách, gạch ngang và dấu chấm đều được bỏ qua.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->get('https://api-tools.hitechcloud.vn/api/vn/numbering/check', [ 'phone' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/vn/numbering/check", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "phone": "GIA_TRI", }, ) data = res.json()