Tài liệu API

Khóa API
Đăng nhập Đăng ký
Các phương thức có sẵn
Phương thức URL Mô tả Cài đặt
GET/POST /api/v1/phone/validate Xác thực số phone, country, api_key
Tham số:
Tham số Mô tả Ví dụ Bắt buộc
api_key Khóa API your_key Có
phone Số điện thoại +393201234567 Có
country Mã quốc gia IT, ["IT","US","DE"] Không
Làm việc với nhiều quốc gia

Tham số country hỗ trợ nhiều định dạng:

  • Một quốc gia: IT
  • Nhiều quốc gia phân cách bằng dấu phẩy: IT,US,DE
  • Nhiều quốc gia phân cách bằng dấu chấm phẩy: IT;US;DE
  • Nhiều quốc gia phân cách bằng khoảng trắng: IT US DE
  • Mảng quốc gia (POST): ["IT", "US", "DE"]

API cố gắng phân tích số với mỗi quốc gia lần lượt cho đến khi tìm thấy kết quả hợp lệ. Điều này đặc biệt hữu ích cho các số ở định dạng quốc gia.

Mã phản hồi
Mã Mô tả Ví dụ
200 Yêu cầu thành công 
{
  "success": true,
  "data": {
    "is_valid": true,
    "type_id": 1,
    "type_name": "Mobile",
    "is_mobile": true,
    "is_fixed_line": false,
    "phone_code": "+39",
    "country_code": "IT",
    "location": null,
    "international": "+39 320 123 4567",
    "national": "320 123 4567",
    "e164": "+393201234567",
    "rfc3966": "tel:+39-320-123-4567"
  },
  "error": null,
  "request_id": "a430273e63f07ef5805f04e5f8a94d16f0351fd7"
}
400 Yêu cầu không hợp lệ (lỗi trong tham số) 
{
  "success": false,
  "data": null,
  "error": "Invalid phone number",
  "request_id": "b1e2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}
401 Không được ủy quyền (khóa API không hợp lệ hoặc thiếu) 
{
  "success": false,
  "data": null,
  "error": "Invalid API key",
  "request_id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7"
}
403 Truy cập bị từ chối (không có quyền hoặc bị chặn) 
{
  "success": false,
  "data": null,
  "error": "Access denied",
  "request_id": "d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8"
}
404 Phương thức hoặc tài nguyên không tìm thấy 
{
  "success": false,
  "data": null,
  "error": "Method or resource not found",
  "request_id": "e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9"
}
429 Vượt quá giới hạn yêu cầu 
{
  "success": false,
  "data": null,
  "error": "Request limit exceeded",
  "request_id": "f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0"
}
500 Lỗi nội bộ máy chủ 
{
  "success": false,
  "data": null,
  "error": "Internal server error",
  "request_id": "a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1"
}
Khóa API thử nghiệm: test
Nếu bạn sử dụng khóa này trong các yêu cầu, API luôn trả về phản hồi trình diễn (mock).
Số dư không được trừ, các kiểm tra thực tế không được thực hiện.
Ví dụ: 
curl "https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=test"
Ví dụ sử dụng
Lệnh cURL
Xác thực số:
cURL 
curl "https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=your_key"
Với nhiều quốc gia:
cURL 
curl "https://numlook.ru/api/v1/phone/validate?phone=3201234567&country=IT,US,DE&api_key=your_key"
Yêu cầu POST với mảng quốc gia:
cURL 
curl -X POST "https://numlook.ru/api/v1/phone/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "3201234567",
    "country": ["IT", "US", "DE"],
    "api_key": "your_key"
  }'
JavaScript (fetch)
Xác thực số:
JavaScript 
// Number validation
fetch('https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=your_key')
.then(response => response.json())
.then(data => console.log(data));
Với nhiều quốc gia:
JavaScript 
// With multiple countries
fetch('https://numlook.ru/api/v1/phone/validate?phone=3201234567&country=IT,US,DE&api_key=your_key')
.then(response => response.json())
.then(data => console.log(data));
Yêu cầu POST với mảng quốc gia:
JavaScript 
// POST request with array of countries
fetch('https://numlook.ru/api/v1/phone/validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '3201234567',
    country: ['IT', 'US', 'DE'],
    api_key: 'your_key'
  })
})
.then(response => response.json())
.then(data => console.log(data));
PHP
Xác thực một số:
PHP 
// Single number validation
$apiKey = 'your_key';
$phone = '+393201234567';

$response = file_get_contents(
    "https://numlook.ru/api/v1/phone/validate?phone=" . urlencode($phone) . "&api_key=" . $apiKey
);

$data = json_decode($response, true);
var_dump($data);
Với nhiều quốc gia:
PHP 
// With multiple countries
$apiKey = 'your_key';
$phone = '3201234567';
$countries = 'IT,US,DE';

$response = file_get_contents(
    "https://numlook.ru/api/v1/phone/validate?phone=" . urlencode($phone) . "&country=" . urlencode($countries) . "&api_key=" . $apiKey
);

$data = json_decode($response, true);
var_dump($data);
Yêu cầu POST với mảng quốc gia:
PHP 
// POST request with array of countries
$apiKey = 'your_key';
$postData = json_encode([
    'phone' => '3201234567',
    'country' => ['IT', 'US', 'DE'],
    'api_key' => $apiKey
]);

$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/json',
        'content' => $postData
    ]
]);

$response = file_get_contents('https://numlook.ru/api/v1/phone/validate', false, $context);
$data = json_decode($response, true);
var_dump($data);