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

Παγκόσμια τηλεφωνικά δεδομένα

Ένας αριθμός, συνεπής έξοδος

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

Αρχική είσοδος+1 212 867 5309

Έξοδος E.164+12128675309

ΕπικύρωσηisValid και isPossible

ΜορφοποίησηΕθνική, διεθνής και E.164

ΤαξινόμησηΚινητό, σταθερό, VoIP και άλλα

ΤοποθεσίαΠεριοχή, κωδικός και τόπος

Παράμετροι εισόδου

Αριθμός και γεωγραφικό πλαίσιο

Παράμετρος	Απαίτηση	Περιγραφή
`number`	Απαιτείται	Αριθμός σε εθνική, διεθνή ή E.164 μορφή.
`address`	Υπό συνθήκη	ISO κωδικός χώρας, χώρα, πόλη ή περιοχή για ερμηνεία εθνικού αριθμού.

Πότε απαιτείται το address

Αν το number δεν αρχίζει με + και διεθνή κωδικό κλήσης, δώστε πλαίσιο όπως US, United States ή New York.

GRGreeceΑθήναNew YorkÉtats-Unis

GET

Έλεγχος ταυτότητας query string

Βασικό αίτημα GET

cURL

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

Κωδικοποίηση URL: Κωδικοποιήστε το + ως %2B και τα κενά ως %20. Προτιμήστε εργαλεία URL/URLSearchParams.

POST

Bearer authentication

Server-side αίτημα 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":"+12128675309","address":"US"}'

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: "+12128675309", address: "United States" })
});

Απόκριση API

Επικύρωση, μορφοποίηση και μεταδεδομένα

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "US", "countryCode": 1, "country": "United 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)"
}

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

Πεδίο	Τύπος	Περιγραφή
`status`	boolean	Αν το αίτημα ολοκληρώθηκε επιτυχώς.
`remaining_credits`	integer	Διαθέσιμες μονάδες μετά το αίτημα.
`expires`	integer	Λήξη μονάδων ως UNIX timestamp.
`duration`	string	Χρόνος επεξεργασίας server.
`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

Τηλεφωνικός αριθμός Voice over IP.

PERSONAL_NUMBER

Προσωπικός αριθμός που μπορεί να προωθεί σε άλλη γραμμή.

PAGER

Αριθμός ειδοποίησης pager.

UAN

Universal Access Number για κοινό εταιρικό σημείο επικοινωνίας.

VOICEMAIL

Αποκλειστικός αριθμός πρόσβασης voicemail.

UNKNOWN

Η κατηγορία δεν προσδιορίστηκε.

Συχνές ερωτήσεις

FAQ για το Phone API

Τι κάνει το API επικύρωσης τηλεφώνου;

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

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

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

Πότε απαιτείται το address;

Δώστε address όταν ο αριθμός δεν αρχίζει με σύμβολο συν και διεθνή κωδικό. Μπορεί να είναι ISO κωδικός χώρας, χώρα, πόλη ή περιοχή.

Πώς αποστέλλονται οι ειδικοί χαρακτήρες;

Κωδικοποιήστε σε URL τα κενά, το σύμβολο συν και άλλους ειδικούς χαρακτήρες στα GET query parameters. Τα JSON POST bodies κωδικοποιούνται από τον HTTP client.

Επόμενη αναφορά

Παρακολουθήστε χρήση και όρια

Χρήση & όριαΚατανοήστε μονάδες και περιορισμούς →Βιβλιοθήκες clientΕγκαταστήστε πακέτο επικύρωσης τηλεφώνου →