API-documentatie

API-sleutel
Inloggen Registratie
Beschikbare methoden
Methode URL Beschrijving Instellingen
GET/POST /api/v1/phone/validate Nummervalidatie phone, country, api_key
Parameters:
Parameter Beschrijving Voorbeeld Verplicht
api_key API-sleutel your_key Ja
phone Telefoonnummer +393201234567 Ja
country Landcode IT, ["IT","US","DE"] Nee
Werken met meerdere landen

Parameter country ondersteunt meerdere formaten:

  • Eén land: IT
  • Meerdere landen gescheiden door komma: IT,US,DE
  • Meerdere landen gescheiden door puntkomma: IT;US;DE
  • Meerdere landen gescheiden door spatie: IT US DE
  • Array van landen (POST): ["IT", "US", "DE"]

API probeert het nummer met elk land achtereenvolgens te parseren totdat een geldig resultaat wordt gevonden. Dit is vooral nuttig voor nummers in nationaal formaat.

Antwoordcodes
Code Beschrijving Voorbeeld
200 Succesvol verzoek 
{
  "success": true,
  "data": {
    "is_valid": true,
    "type_id": 1,
    "type_name": "Mobile",
    "is_mobile": true,
    "is_fixed_line": false,
    "phone_code": "+39",
    "country_code": "IT",
    "location": null,
    "international": "+39 320 123 4567",
    "national": "320 123 4567",
    "e164": "+393201234567",
    "rfc3966": "tel:+39-320-123-4567"
  },
  "error": null,
  "request_id": "a430273e63f07ef5805f04e5f8a94d16f0351fd7"
}
400 Ongeldig verzoek (fout in parameters) 
{
  "success": false,
  "data": null,
  "error": "Invalid phone number",
  "request_id": "b1e2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}
401 Niet geautoriseerd (ongeldige of ontbrekende API-sleutel) 
{
  "success": false,
  "data": null,
  "error": "Invalid API key",
  "request_id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7"
}
403 Toegang geweigerd (geen rechten of geblokkeerd) 
{
  "success": false,
  "data": null,
  "error": "Access denied",
  "request_id": "d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8"
}
404 Methode of resource niet gevonden 
{
  "success": false,
  "data": null,
  "error": "Method or resource not found",
  "request_id": "e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9"
}
429 Verzoeklimiet overschreden 
{
  "success": false,
  "data": null,
  "error": "Request limit exceeded",
  "request_id": "f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0"
}
500 Interne serverfout 
{
  "success": false,
  "data": null,
  "error": "Internal server error",
  "request_id": "a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1"
}
Test API-sleutel: test
Als u deze sleutel gebruikt in verzoeken, retourneert de API altijd een demonstratie (mock) antwoord.
Saldo wordt niet afgeschreven, echte controles worden niet uitgevoerd.
Voorbeeld: 
curl "https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=test"
Gebruiksvoorbeelden
cURL-commando’s
Nummer validatie:
cURL 
curl "https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=your_key"
Met meerdere landen:
cURL 
curl "https://numlook.ru/api/v1/phone/validate?phone=3201234567&country=IT,US,DE&api_key=your_key"
POST-aanvraag met landenlijst:
cURL 
curl -X POST "https://numlook.ru/api/v1/phone/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "3201234567",
    "country": ["IT", "US", "DE"],
    "api_key": "your_key"
  }'
JavaScript (fetch)
Nummer validatie:
JavaScript 
// Number validation
fetch('https://numlook.ru/api/v1/phone/validate?phone=+393201234567&api_key=your_key')
.then(response => response.json())
.then(data => console.log(data));
Met meerdere landen:
JavaScript 
// With multiple countries
fetch('https://numlook.ru/api/v1/phone/validate?phone=3201234567&country=IT,US,DE&api_key=your_key')
.then(response => response.json())
.then(data => console.log(data));
POST-aanvraag met landenlijst:
JavaScript 
// POST request with array of countries
fetch('https://numlook.ru/api/v1/phone/validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '3201234567',
    country: ['IT', 'US', 'DE'],
    api_key: 'your_key'
  })
})
.then(response => response.json())
.then(data => console.log(data));
PHP
Enkel nummer validatie:
PHP 
// Single number validation
$apiKey = 'your_key';
$phone = '+393201234567';

$response = file_get_contents(
    "https://numlook.ru/api/v1/phone/validate?phone=" . urlencode($phone) . "&api_key=" . $apiKey
);

$data = json_decode($response, true);
var_dump($data);
Met meerdere landen:
PHP 
// With multiple countries
$apiKey = 'your_key';
$phone = '3201234567';
$countries = 'IT,US,DE';

$response = file_get_contents(
    "https://numlook.ru/api/v1/phone/validate?phone=" . urlencode($phone) . "&country=" . urlencode($countries) . "&api_key=" . $apiKey
);

$data = json_decode($response, true);
var_dump($data);
POST-aanvraag met landenlijst:
PHP 
// POST request with array of countries
$apiKey = 'your_key';
$postData = json_encode([
    'phone' => '3201234567',
    'country' => ['IT', 'US', 'DE'],
    'api_key' => $apiKey
]);

$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/json',
        'content' => $postData
    ]
]);

$response = file_get_contents('https://numlook.ru/api/v1/phone/validate', false, $context);
$data = json_decode($response, true);
var_dump($data);