API Επικύρωσης & Μορφοποίησης Αριθμών Τηλεφώνου

Το API Επικύρωσης Τηλεφώνου υποστηρίζεται σε 242 χώρες.

Το API Επικύρωσης & Μορφοποίησης Αριθμών Τηλεφώνου σας επιτρέπει να επεξεργάζεστε εύκολα αριθμούς τηλεφώνου που έχουν εισαχθεί από χρήστες σε διάφορες μορφές. Είτε η είσοδος είναι τόσο ανομοιογενής όπως 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309 ή απλά 2128675309, το API μας εντοπίζει έξυπνα τη δομή και επιστρέφει μια τυποποιημένη εκδοχή.

Αυτό το εργαλείο μετατρέπει αυτόματα την είσοδο στη μορφή E.164, που είναι η διεθνώς αναγνωρισμένη μορφή για αριθμούς τηλεφώνου. Για παράδειγμα, ο αριθμός +1 212 867 5309 επιστρέφεται ως +12128675309, καθιστώντας τον κατάλληλο για διεθνείς κλήσεις και ενσωματώσεις.

Πέρα από τη μορφοποίηση, το API προσφέρει λεπτομερείς δυνατότητες επικύρωσης αριθμών τηλεφώνου. Ελέγχει αν ο αριθμός είναι isValid: true — δηλαδή έγκυρος σύμφωνα με τα εθνικά πρότυπα αρίθμησης. Προσφέρει επίσης τον έλεγχο isPossible: true, που δείχνει αν ο αριθμός μπορεί ενδεχομένως να υπάρχει ακόμη κι αν δεν έχει εκχωρηθεί ακόμη. Αυτό είναι χρήσιμο για προ-επικύρωση πριν από την αποθήκευση ή επεξεργασία.

Η παράμετρος numberType βοηθά στον προσδιορισμό αν ο αριθμός είναι κινητός, σταθερός ή VoIP. Είναι ιδιαίτερα χρήσιμο όταν θέλετε να επιτρέπονται μόνο κινητά για επαληθεύσεις SMS ή σταθερά για επαγγελματικές επαφές.

Με υποστήριξη για αναγνώριση κωδικού περιοχής, το API μπορεί επίσης να εντοπίσει τη γεωγραφική προέλευση του αριθμού. Για παράδειγμα, ένας αριθμός που ξεκινά με τον κωδικό περιοχής 212 αντιστοιχίζεται αυτόματα στη Νέα Υόρκη (Μανχάταν). Αυτή η δυνατότητα είναι ιδανική για εφαρμογές που απαιτούν τμηματοποίηση ή ανάλυση βάσει τοποθεσίας.

Κάθε αριθμός συσχετίζεται επίσης με λεπτομερή μεταδεδομένα σε επίπεδο χώρας, όπως ο κωδικός περιοχής ISO (π.χ. US) και ο αριθμητικός κωδικός χώρας (π.χ. 1), επιτρέποντας λογική και μορφοποιήσεις προβολής ανά περιοχή στις εφαρμογές σας.

✅ Απόκριση API

Παράδειγμα JSON απόκρισης:

{
  "status": true,
  "remaining_credits": 15709,
  "expires": 0,
  "duration": "18ms",
  "regionCode": "US",
  "countryCode": 1,
  "country":"Unites States",
  "national": "(212) 867-5309",
  "international": "+1 212-867-5309",
  "e164": "+12128675309",
  "isValid": true,
  "isPossible": true,
  "numberType": "FIXED_LINE_OR_MOBILE",
  "nationalSignificantNumber": "2128675309",
  "rawInput": "+1 212 867 5309",
  "isGeographical": true,
  "areaCode": "212",
  "location": "New York City (Manhattan)"
}

Δοκιμάστε το API Επικύρωσης Τηλεφώνου Μόνοι Σας

Βασική Χρήση

Στείλτε έναν αριθμό τηλεφώνου στο παρακάτω endpoint:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309

Μπορείτε να αποκτήσετε το καθημερινό δωρεάν API κλειδί με 200 credits από αυτόν τον σύνδεσμο.

Παράμετρος Address

Το API υποστηρίζει επίσης την προαιρετική παράμετρο address, η οποία είναι ιδιαίτερα χρήσιμη όταν ο αριθμός τηλεφώνου παρέχεται χωρίς διεθνή κωδικό χώρας. Αυτό το πεδίο βοηθά το σύστημα να ανιχνεύσει την προβλεπόμενη περιοχή και να αναλύσει σωστά τον αριθμό. Για παράδειγμα, αν η είσοδος είναι 2128675309 και δεν έχει καθοριστεί κωδικός χώρας, η ρύθμιση address=US, address=United States ή ακόμα και address=New York μπορεί να βοηθήσει το API να αναγνωρίσει ότι ο αριθμός ανήκει στις Ηνωμένες Πολιτείες.

Η παράμετρος address δέχεται τιμές σε πολλές μορφές, όπως:

• Κωδικοί ISO 3166-1 alpha-2 όπως US, DE ή TR
• Ονόματα χωρών όπως Germany, Turkey ή America
• Ονόματα πόλεων ή περιοχών όπως Berlin, Istanbul ή New York

Αν και προαιρετική, η παράμετρος address γίνεται υποχρεωτική αν ο αριθμός τηλεφώνου δεν ξεκινά με σύμβολο συν και διεθνή κωδικό κλήσης (π.χ. +1, +44, +90). Χωρίς αυτές τις πληροφορίες, το API ενδέχεται να μην μπορεί να ερμηνεύσει σωστά τον αριθμό.

Παράδειγμα με παράμετρο address:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309&address=US

Πεδία Απόκρισης

Τιμές Τύπου Αριθμού

curl "https://api.genderapi.io/api/phone?number=+49 151 12345678&address=United States&key=YOUR_API_KEY"

curl "https://api.genderapi.io/api/phone?number=%2B49%20151%2012345678&address=United%20States&key=YOUR_API_KEY"

API Επικύρωσης Τηλεφώνου μέσω POST Αιτήματος

Μπορείτε να χρησιμοποιήσετε τη μέθοδο POST για να επικυρώσετε έναν αριθμό τηλεφώνου για τις Ηνωμένες Πολιτείες. Απλώς παρέχετε τον αριθμό τηλεφώνου σε μορφή E.164, εθνική ή διεθνή, μαζί με τη χώρα/διεύθυνση. Το API key σας πρέπει να σταλεί ως Bearer token.

Παράδειγμα με cURL

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

PHP cURL Example

<?php
$url = "https://api.genderapi.io/api/phone";

$data = array(
    "number" => "+12128675309",
    "address" => "US"
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Παράδειγμα με JavaScript fetch

fetch("https://api.genderapi.io/api/phone", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    number: "+12128675309",
    address: "United States"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Παράδειγμα με Python requests

import requests

url = "https://api.genderapi.io/api/phone"

payload = {
    "number": "+12128675309",
    "address": "United States"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Βιβλιοθήκες Πελατών

Για να κάνουμε την ενσωμάτωση ακόμα πιο εύκολη, προσφέρουμε μια σειρά από επίσημες και υποστηριζόμενες από την κοινότητα βιβλιοθήκες πελατών για διαφορετικές γλώσσες προγραμματισμού. Αυτές οι βιβλιοθήκες σας επιτρέπουν να αλληλεπιδράτε με τα endpoints του GenderAPI — όπως το API Επικύρωσης Αριθμών Τηλεφώνου — χωρίς να χρειάζεται να χειρίζεστε χειροκίνητα τα αιτήματα HTTP ή την ανάλυση JSON. Απλά επιλέξτε τη βιβλιοθήκη που ταιριάζει στο περιβάλλον σας, εγκαταστήστε την και ξεκινήστε να στέλνετε αιτήματα με ελάχιστη ρύθμιση.

Μπορείτε να βρείτε τις διαθέσιμες βιβλιοθήκες πελατών και οδηγίες εγκατάστασης στην παρακάτω σελίδα:
https://www.genderapi.io/el/docs-client-libraries

Συχνές Ερωτήσεις (FAQ)

1. Τι είναι το Phone Number Validation & Formatter API;

Το Phone Number Validation & Formatter API είναι ένα εργαλείο που σας επιτρέπει να επικυρώνετε, να μορφοποιείτε και να αναλύετε αριθμούς τηλεφώνου από όλο τον κόσμο. Μπορεί να μετατρέψει αριθμούς στη τυποποιημένη μορφή E.164 και να προσδιορίσει μεταδεδομένα όπως περιοχή, τύπος (κινητό/σταθερό), εγκυρότητα και άλλα.

2. Πού χρησιμοποιείται η Επικύρωση Αριθμού Τηλεφώνου;

Χρησιμοποιείται για τον έλεγχο αν ένας αριθμός είναι έγκυρος, για τη μορφοποίησή του για διεθνή χρήση, για τον προσδιορισμό του τύπου του (π.χ. κινητό, VoIP), για την ανίχνευση μεταδεδομένων περιοχής, και για να διασφαλίσει καθαρή και τυποποιημένη εισαγωγή αριθμών σε CRM, εργαλεία marketing ή φόρμες εγγραφής.

3. Πόσες χώρες υποστηρίζονται;

Το API υποστηρίζει αριθμούς τηλεφώνου από 242 χώρες και περιοχές παγκοσμίως. Αυτό εξασφαλίζει παγκόσμια κάλυψη για κάθε διεθνή ή τοπική εφαρμογή.

4. Ποιοι μορφοτύποι υποστηρίζονται;

Το API δέχεται αριθμούς σε διάφορους μορφοτύπους όπως εθνικός, διεθνής ή E.164. Εντοπίζει και τους κανονικοποιεί αυτόματα στη σωστή μορφή.

5. Τι γίνεται αν παραλείψω την παράμετρο χώρας ή διεύθυνσης;

Αν ο αριθμός δεν ξεκινά με + και δεν παρέχεται παράμετρος χώρας ή διεύθυνσης, το API ενδέχεται να μην μπορέσει να ερμηνεύσει σωστά τον αριθμό. Συνιστάται η χρήση της παραμέτρου address (όπως US, United States ή New York).

6. Μπορεί το API να ανιχνεύσει τον τύπο του αριθμού;

Ναι. Το API επιστρέφει το πεδίο numberType που δείχνει αν ο αριθμός είναι MOBILE, FIXED_LINE, VOIP κ.λπ.

7. Ποια είναι η διαφορά μεταξύ isValid και isPossible;

isValid σημαίνει ότι ο αριθμός είναι επίσημα εκχωρημένος και συμμορφώνεται με όλους τους τοπικούς κανόνες. isPossible ελέγχει αν η δομή του αριθμού είναι θεωρητικά δυνατή, ακόμα κι αν δεν έχει ακόμα αποδοθεί.

8. Τι είδους απόκριση επιστρέφει το API;

Μια επιτυχής απόκριση περιλαμβάνει status, μορφοποιημένες εκδοχές αριθμού (εθνική, διεθνής, E.164), στοιχεία περιοχής, τύπο αριθμού, χρήση credits και άλλα. Δείτε το παράδειγμα απόκρισης API για πλήρες output.

9. Πώς στέλνω το API key μου;

Για αιτήματα GET, προσθέστε το κλειδί ως ?key=YOUR_API_KEY. Για POST αιτήματα, χρησιμοποιήστε το Bearer token στην κεφαλίδα ως:
"Authorization: Bearer YOUR_API_KEY".

10. Τι σημαίνει όταν βλέπω status: false στην απόκριση;

Αυτό σημαίνει ότι το αίτημα απέτυχε. Το πεδίο message θα περιέχει τον λόγο αποτυχίας, όπως ελλιπείς παράμετροι, άκυρος αριθμός ή ανεπαρκή credits.

11. Επιτρέπονται ειδικοί χαρακτήρες ή κενά στις εισόδους;

Ναι, αλλά πρέπει να είναι URL-encoded για αιτήματα GET. Για παράδειγμα, χρησιμοποιήστε %20 αντί για κενό. Δείτε την ενότητα προειδοποίησης παραπάνω για σωστή χρήση.

12. Μπορώ να χρησιμοποιήσω διευθύνσεις σε διαφορετικούς μορφοτύπους ή γλώσσες;

Ναι. Εκτός από τους κωδικούς ISO 3166-1 alpha-2 (όπως US, DE, TR), η παράμετρος address δέχεται και πλήρη ονόματα χωρών ή πόλεων — ακόμη και σε άλλες γλώσσες. Το API χρησιμοποιεί ενσωματωμένη τεχνητή νοημοσύνη για να ανιχνεύσει και να ερμηνεύσει σωστά τη χώρα ή την περιοχή. Για παράδειγμα:

address=Deutschland
address=États-Unis
address=İstanbul
address=New York
address=Estados Unidos

Όλες αυτές οι εισόδους θα αντιστοιχιστούν σωστά στις αντίστοιχες χώρες ή περιοχές από το API χωρίς πρόβλημα.