API-ul nostru este rapid și ușor de integrat — poți fi funcțional în mai puțin de 15 minute. În plus, primești 50 cereri gratuite în fiecare zi pentru a începe.
Toate cererile API trebuie trimise folosind metoda POST. Endpoint-ul de bază pentru toate cererile este:
https://numvalid.com/api/v1/[api_key]
Înlocuiește [api_key] cu cheia ta personală API. Toți parametrii cererii trebuie trimiși în body-ul requestului în format JSON. Poți obține cheia API din panoul tău de control după înregistrare.
Metodă: test
Această metodă este folosită pentru a testa conexiunea API. Verifică dacă cheia ta API este validă și dacă serviciul este accesibil. Dacă totul este configurat corect, API-ul va returna un răspuns de succes.
Exemplu de cerere
{
"method": "test"
}Răspuns cu succes
{
"error": 0,
"message": "Yippee-ki-yay"
}
Câmpuri de răspuns
error — cod de eroare (0 înseamnă că cererea a fost reușită)
message — mesaj de răspuns de la API
Metodă: info
Metoda info returnează informații despre contul tău și abonamentul curent, inclusiv numărul de cereri API utilizate.
Exemplu de cerere
{
"method": "info"
}Răspuns cu succes
{
"error": 0,
"name": "John",
"surname": "Smith",
"email": "[email protected]",
"subscription": "Growth",
"count_request": 2349
}
Câmpuri de răspuns
error — cod de eroare (0 înseamnă că cererea a fost reușită)
name — prenumele proprietarului contului
surname — numele de familie al proprietarului contului
email — adresa de email a contului
subscription — planul curent de abonament
count_request — numărul de cereri API utilizate în perioada curentă de abonament
Metodă: verify
Metoda verify verifică un număr de telefon și returnează informații detaliate de validare.
Numerele de telefon pot fi furnizate în orice format. API-ul gestionează automat caractere precum (, ), -, + și spații.
Exemplu de cerere
{
"phone": "491609502065",
"method": "verify"
}Răspuns cu succes
{
"error": 0,
"request_phone": "491609502065",
"valid_phone": true,
"type": "mobile",
"format": {
"local": "01609502065",
"international": "+491609502065"
},
"country": {
"code": "DE",
"name": "Germany (Federal Republic of)",
"prefix": "+49"
},
"requests": {
"subscription": "Growth",
"count": 2,
"start": "2026-04-06 10:29:40",
"finish": "2026-10-06 10:29:40",
"limit": 9000
}
}
Câmpuri de răspuns
error — cod de eroare (0 înseamnă că cererea a fost reușită)
request_phone — numărul de telefon trimis în cerere
valid_phone — rezultatul validării (true dacă numărul este valid)
type — tipul numărului de telefon (de ex. mobil, fix etc.)
Obiect Format
local — numărul de telefon în format local
international — numărul de telefon în format internațional
Obiect Țară
code — cod ISO al țării
name — numele țării
prefix — prefix internațional de apelare
Obiect Requests
Informații despre utilizarea curentă a abonamentului tău.
subscription — plan de abonament activ
count — numărul de cereri deja utilizate
start — data de început a perioadei de abonament
finish — data de sfârșit a perioadei de abonament
limit — numărul maxim de cereri permise în perioada de abonament
Ai întrebări despre documentația API? Contactează-ne: