Մեր API-ն արագ է և հեշտ ինտեգրվող — կարող եք սկսել օգտագործել այն 15 րոպեից պակաս ժամանակում։ Բացի այդ, դուք ստանում եք օրական 50 անվճար հարցումներ սկսելու համար։
Բոլոր API հարցումները պետք է ուղարկվեն POST մեթոդով։ Բոլոր հարցումների հիմնական endpoint-ը հետևյալն է:
https://numvalid.com/api/v1/[api_key]
Փոխարինեք [api_key]-ը ձեր անձնական API բանալիով։ Բոլոր հարցման պարամետրերը պետք է ուղարկվեն JSON ձևաչափով request body-ում։ Դուք կարող եք ստանալ ձեր API բանալին գրանցումից հետո՝ ձեր անձնական վահանակից։
Մեթոդ: test
Այս մեթոդը օգտագործվում է API կապը ստուգելու համար։ Այն ստուգում է՝ արդյոք ձեր API բանալին վավեր է և ծառայությունը հասանելի է։ Եթե ամեն ինչ ճիշտ է կարգավորված, API-ն կվերադարձնի հաջող պատասխան։
Հարցման օրինակ
{
"method": "test"
}Հաջող պատասխան
{
"error": 0,
"message": "Yippee-ki-yay"
}
Պատասխանի դաշտեր
error — սխալի կոդ (0 նշանակում է հաջող հարցում)
message — API-ի պատասխան հաղորդագրություն
Մեթոդ: info
info մեթոդը վերադարձնում է տեղեկություն ձեր հաշվի և ընթացիկ բաժանորդագրության մասին, ներառյալ օգտագործված API հարցումների քանակը։
Հարցման օրինակ
{
"method": "info"
}Հաջող պատասխան
{
"error": 0,
"name": "John",
"surname": "Smith",
"email": "[email protected]",
"subscription": "Growth",
"count_request": 2349
}
Պատասխանի դաշտեր
error — սխալի կոդ (0 նշանակում է հաջող հարցում)
name — հաշվի սեփականատիրոջ անուն
surname — հաշվի սեփականատիրոջ ազգանուն
email — հաշվի էլ. փոստ
subscription — ընթացիկ բաժանորդագրության պլան
count_request — ընթացիկ ժամանակահատվածում օգտագործված API հարցումների քանակ
Մեթոդ: verify
verify մեթոդը ստուգում է հեռախոսահամարը և վերադարձնում մանրամասն վավերացման տվյալներ։
Հեռախոսահամարները կարող են տրվել ցանկացած ձևաչափով։ API-ն ավտոմատ կերպով մշակում է այնպիսի նշաններ, ինչպիսիք են
(, ), -,
+ և բացատները։
Հարցման օրինակ
{
"phone": "491609502065",
"method": "verify"
}Հաջող պատասխան
{
"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
}
}
Պատասխանի դաշտեր
error — սխալի կոդ (0 նշանակում է հաջող հարցում)
request_phone — հարցման մեջ ուղարկված հեռախոսահամար
valid_phone — վավերացման արդյունք (true եթե համարը վավեր է)
type — հեռախոսահամարի տեսակ (օր.՝ բջջային, ֆիքսված և այլն)
Ֆորմատի օբյեկտ
local — տեղական ձևաչափով հեռախոսահամար
international — միջազգային ձևաչափով հեռախոսահամար
Երկրի օբյեկտ
code — ISO երկրի կոդ
name — երկրի անուն
prefix — միջազգային կոդ
Request-ների օբյեկտ
Տեղեկություն ձեր ընթացիկ բաժանորդագրության օգտագործման մասին։
subscription — ակտիվ բաժանորդագրության պլան
count — արդեն օգտագործված հարցումների քանակ
start — բաժանորդագրության սկիզբ
finish — բաժանորդագրության ավարտ
limit — թույլատրված առավելագույն հարցումների քանակ
Ունե՞ք հարցեր մեր API փաստաթղթերի մասին։ Կապվեք մեզ հետ՝