API ตรวจสอบและจัดรูปแบบหมายเลขโทรศัพท์

ข้อมูลหมายเลขโทรศัพท์ทั่วโลก

หนึ่งหมายเลข ผลลัพธ์เป็นมาตรฐานเดียวกัน

รองรับข้อมูลแบบภายในประเทศ แบบสากล และรูปแบบที่ไม่สม่ำเสมอ แล้วส่งคืนรูปแบบมาตรฐานพร้อมข้อมูลตรวจสอบสำหรับ 242 ประเทศและดินแดน

ข้อมูลดิบ+66 81 234 5678

ผลลัพธ์ E.164+66812345678

การตรวจสอบisValid และ isPossible

การจัดรูปแบบภายในประเทศ สากล และ E.164

การจำแนกประเภทมือถือ โทรศัพท์พื้นฐาน VoIP และประเภทอื่น

ตำแหน่งภูมิภาค รหัสพื้นที่ และสถานที่

พารามิเตอร์อินพุต

หมายเลขและข้อมูลพื้นที่ประกอบ

พารามิเตอร์	ข้อกำหนด	คำอธิบาย
`number`	จำเป็น	หมายเลขโทรศัพท์ในรูปแบบภายในประเทศ สากล หรือ E.164
`address`	มีเงื่อนไข	รหัสประเทศ ISO ชื่อประเทศ เมือง หรือภูมิภาค สำหรับตีความหมายเลขภายในประเทศ

กรณีที่ต้องส่ง address

หาก number ไม่ได้ขึ้นต้นด้วย + และรหัสโทรศัพท์ระหว่างประเทศ ให้ส่งข้อมูลพื้นที่ เช่นTH, Thailand หรือ Bangkok

THThailandBangkokเชียงใหม่ประเทศไทย

GET

ยืนยันตัวตนผ่าน query string

คำขอ GET พื้นฐาน

cURL

curl "https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=%2B66812345678&address=TH"

การเข้ารหัส URL: เข้ารหัส + เป็น %2B และช่องว่างเป็น %20 ควรใช้ URL หรือ URLSearchParams ของภาษาที่ใช้งานแทนการต่อสตริงด้วยตนเอง

POST

ยืนยันตัวตนแบบ Bearer

คำขอ POST ฝั่งเซิร์ฟเวอร์

ส่งหมายเลขและ address ซึ่งเป็นตัวเลือกในรูปแบบ JSON พร้อม API key ใน Authorization header

cURL

curl -X POST "https://api.genderapi.io/api/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"number":"+66812345678","address":"TH"}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/phone", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ number: "+66812345678", address: "Thailand" })
});

การตอบกลับจาก API

ผลการตรวจสอบ รูปแบบ และข้อมูลประกอบ

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "TH", "countryCode": 66, "country": "Thailand",
  "national": "081 234 5678", "international": "+66 81 234 5678", "e164": "+66812345678",
  "isValid": true, "isPossible": true, "numberType": "MOBILE",
  "nationalSignificantNumber": "812345678", "rawInput": "+66 81 234 5678",
  "isGeographical": false, "areaCode": "", "location": ""
}

ฟิลด์ในการตอบกลับ

ฟิลด์	ชนิดข้อมูล	คำอธิบาย
`status`	boolean	ระบุว่าคำขอประมวลผลสำเร็จหรือไม่
`remaining_credits`	integer	จำนวนเครดิตที่เหลือหลังจากส่งคำขอ
`expires`	integer	เวลาหมดอายุของเครดิตในรูปแบบ UNIX timestamp
`duration`	string	ระยะเวลาที่เซิร์ฟเวอร์ใช้ประมวลผล
`regionCode`	string	รหัสภูมิภาค ISO 3166-1 alpha-2 ที่ตรวจพบ
`countryCode`	integer	รหัสโทรศัพท์ระหว่างประเทศ
`country`	string	ชื่อประเทศที่อ่านเข้าใจได้
`national`	string	หมายเลขที่จัดรูปแบบสำหรับใช้ภายในประเทศ
`international`	string	หมายเลขที่จัดรูปแบบสำหรับแสดงผลแบบสากล
`e164`	string	หมายเลขในรูปแบบมาตรฐาน E.164
`isValid`	boolean	ระบุว่าหมายเลขเป็นไปตามกฎของระบบหมายเลขในภูมิภาคหรือไม่
`isPossible`	boolean	ระบุว่าโครงสร้างของหมายเลขมีความเป็นไปได้หรือไม่
`numberType`	string	ประเภทหมายเลขโทรศัพท์ที่ตรวจพบ
`nationalSignificantNumber`	string	หมายเลขภายในประเทศโดยไม่รวมรหัสโทรศัพท์ประเทศ
`rawInput`	string	หมายเลขต้นฉบับที่ส่งมากับคำขอ
`isGeographical`	boolean	ระบุว่าสามารถเชื่อมโยงหมายเลขกับพื้นที่ทางภูมิศาสตร์ได้หรือไม่
`areaCode`	string	ส่วนรหัสพื้นที่ที่ตรวจพบ
`location`	string	ตำแหน่งที่ตั้งซึ่งสัมพันธ์กับรหัสพื้นที่

ข้อมูลอ้างอิงการจำแนกประเภท

ค่าประเภทหมายเลข

FIXED_LINE

โทรศัพท์พื้นฐานที่เชื่อมโยงกับพื้นที่ทางภูมิศาสตร์

MOBILE

หมายเลขโทรศัพท์มือถือ

FIXED_LINE_OR_MOBILE

ระบบหมายเลขไม่สามารถแยกโทรศัพท์พื้นฐานกับมือถือได้

TOLL_FREE

หมายเลขโทรฟรีซึ่งผู้รับเป็นผู้รับผิดชอบค่าโทร

PREMIUM_RATE

หมายเลขบริการอัตราค่าบริการพิเศษ

SHARED_COST

หมายเลขที่แบ่งค่าโทรระหว่างผู้โทรและผู้รับ

VOIP

หมายเลขโทรศัพท์ผ่านอินเทอร์เน็ต

PERSONAL_NUMBER

หมายเลขส่วนบุคคลที่สามารถโอนไปยังสายอื่นได้

PAGER

หมายเลขเพจเจอร์

UAN

หมายเลขเข้าถึงสากลที่ใช้เป็นช่องทางติดต่อร่วมขององค์กร

VOICEMAIL

หมายเลขสำหรับเข้าถึงระบบข้อความเสียงโดยเฉพาะ

UNKNOWN

ไม่สามารถระบุประเภทหมายเลขได้

คำถามที่พบบ่อย

คำถามเกี่ยวกับ Phone API

API ตรวจสอบหมายเลขโทรศัพท์ทำอะไรได้บ้าง?

API ตรวจสอบและปรับหมายเลขโทรศัพท์ให้เป็นมาตรฐาน ส่งคืนรูปแบบภายในประเทศ รูปแบบสากล และ E.164 พร้อมระบุภูมิภาค ประเภทหมายเลข และข้อมูลตำแหน่งเมื่อมีข้อมูล

isValid และ isPossible ต่างกันอย่างไร?

isValid ตรวจสอบหมายเลขตามกฎของระบบหมายเลขในภูมิภาค ส่วน isPossible ระบุว่าโครงสร้างอาจเป็นหมายเลขจริงได้ แม้ยังยืนยันความถูกต้องไม่ได้

ต้องส่ง address เมื่อใด?

ส่ง address เมื่อหมายเลขไม่ได้ขึ้นต้นด้วยเครื่องหมายบวกและรหัสโทรศัพท์ระหว่างประเทศ โดยใช้รหัสประเทศ ISO ชื่อประเทศ เมือง หรือภูมิภาคเป็นค่าได้

ควรส่งอักขระพิเศษอย่างไร?

สำหรับพารามิเตอร์ GET ให้ทำ URL encoding ช่องว่าง เครื่องหมายบวก และอักขระพิเศษ ส่วน body แบบ JSON ของ POST จะถูกเข้ารหัสโดย HTTP client

เอกสารถัดไป

ติดตามการใช้งานและโควตา

การใช้งานและโควตาทำความเข้าใจเครดิตและข้อจำกัด →ไลบรารีไคลเอนต์ติดตั้งแพ็กเกจสำหรับตรวจสอบหมายเลขโทรศัพท์ →