เอกสาร API

คีย์ API
เข้าสู่ระบบ ลงทะเบียน
วิธีการที่ใช้ได้
วิธี URL คำอธิบาย พารามิเตอร์
GET/POST /api/v1/phone/validate การตรวจสอบหมายเลข phone, country, api_key
พารามิเตอร์:
พารามิเตอร์ คำอธิบาย ตัวอย่าง จำเป็น
api_key คีย์ API your_key ใช่
phone หมายเลขโทรศัพท์ +393201234567 ใช่
country รหัสประเทศ IT, ["IT","US","DE"] ไม่
การทำงานกับหลายประเทศ

พารามิเตอร์ country รองรับหลายรูปแบบ:

  • หนึ่งประเทศ: IT
  • หลายประเทศคั่นด้วยเครื่องหมายจุลภาค: IT,US,DE
  • หลายประเทศคั่นด้วยเครื่องหมายอัฒภาค: IT;US;DE
  • หลายประเทศคั่นด้วยช่องว่าง: IT US DE
  • อาร์เรย์ประเทศ (POST): ["IT", "US", "DE"]

API พยายามแยกวิเคราะห์หมายเลขกับแต่ละประเทศตามลำดับจนกว่าจะพบผลลัพธ์ที่ถูกต้อง ซึ่งมีประโยชน์อย่างยิ่งสำหรับหมายเลขในรูปแบบประเทศ

รหัสการตอบสนอง
รหัส คำอธิบาย ตัวอย่าง
200 คำขอสำเร็จ 
{
  "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 คำขอไม่ถูกต้อง (ข้อผิดพลาดในพารามิเตอร์) 
{
  "success": false,
  "data": null,
  "error": "Invalid phone number",
  "request_id": "b1e2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}
401 ไม่ได้รับอนุญาต (คีย์ API ไม่ถูกต้องหรือหายไป) 
{
  "success": false,
  "data": null,
  "error": "Invalid API key",
  "request_id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7"
}
403 การเข้าถึงถูกปฏิเสธ (ไม่มีสิทธิ์หรือถูกบล็อก) 
{
  "success": false,
  "data": null,
  "error": "Access denied",
  "request_id": "d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8"
}
404 ไม่พบวิธีการหรือทรัพยากร 
{
  "success": false,
  "data": null,
  "error": "Method or resource not found",
  "request_id": "e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9"
}
429 เกินขีดจำกัดคำขอ 
{
  "success": false,
  "data": null,
  "error": "Request limit exceeded",
  "request_id": "f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0"
}
500 ข้อผิดพลาดภายในเซิร์ฟเวอร์ 
{
  "success": false,
  "data": null,
  "error": "Internal server error",
  "request_id": "a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1"
}
คีย์ API ทดสอบ: test
หากคุณใช้คีย์นี้ในการร้องขอ API จะส่งคืนการตอบสนองสาธิต (mock) เสมอ
ยอดเงินไม่ถูกหัก การตรวจสอบจริงไม่ดำเนินการ
ตัวอย่าง: 
curl "https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=test"
ตัวอย่างการใช้งาน
คำสั่ง cURL
การตรวจสอบหมายเลข:
cURL 
curl "https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=your_key"
กับหลายประเทศ:
cURL 
curl "https://numlook.ru/api/v1/phone/validate?phone=3201234567&country=IT,US,DE&api_key=your_key"
คำขอ POST พร้อมอาร์เรย์ประเทศ:
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)
การตรวจสอบหมายเลข:
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));
กับหลายประเทศ:
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));
คำขอ POST พร้อมอาร์เรย์ประเทศ:
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
การตรวจสอบหมายเลขเดียว:
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);
กับหลายประเทศ:
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);
คำขอ POST พร้อมอาร์เรย์ประเทศ:
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);