Namsor

API Téléphone – Identifier un préfixe téléphonique

L'API Téléphone de Namsor formate et valide intelligemment les numéros de téléphone en les analysant aux côtés du prénom et nom de famille d'une personne. Que le numéro d'entrée soit formaté ou non formaté, notre API détermine le pays de résidence le plus probable, attribue le bon code de composition internationale, et retourne le numéro au format E.164 standardisé.


Cette API est particulièrement utile pour les applications nécessitant des informations de contact précises, telles que les systèmes CRM, les processus d'intégration utilisateur, et les opérations de nettoyage de données. En incorporant des informations contextuelles des noms, l'API améliore la précision du formatage et de la validation des numéros de téléphone, garantissant des canaux de communication fiables.

Formater Numéro Téléphone

Prefix téléphonique à partir de prénom (optionnel), nom de famille (optionnel), numéro de téléphone .

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Jamini",
    "lastName": "Roy",
    "internationalPhoneNumberVerified": "+91 98042 01420",
    "phoneCountryIso2Verified": "IN",
    "phoneCountryCode": 91,
    "phoneCountryCodeAlt": 98,
    "phoneCountryIso2": "IN",
    "phoneCountryIso2Alt": "IR",
    "originCountryIso2": "BD",
    "originCountryIso2Alt": "ID",
    "phoneNumber": "09804201420",
    "verified": true,
    "score": 7.659341221254494
}

Formater numéro Téléphone analyse un prénom, nom de famille et un numéro de téléphone pour déterminer le préfixe téléphonique international le plus probable, le pays d'origine et le numéro de téléphone correctement formaté.

  • Coût: 11 crédits par nom.
  • Description : Détermine les préfixes téléphonique, les pays de résidence et les formats d'un numéro de téléphone à partir d'un ensemble de prénoms, noms de famille et numéros de téléphone (jusqu'à 100).
  • Plus d'informations sur : Formater Numéro Téléphone

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Corps de la requête
NomTypeRequisDescription
personalNamesWithPhoneNumbersArray of objectsRequisUne liste de prénoms, noms de famille et numéros de téléphone.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom du propriétaire du numéro de téléphone.
[{...}].lastNameStringOptionelNom de famille du propriétaire du numéro de téléphone.
[{...}].phoneNumberStringRequisNuméro de téléphone, formaté ou non formaté.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesWithPhoneNumbersArray of objectsNuméros de téléphone formatés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].internationalPhoneNumberVerifiedStringNuméro de téléphone vérifié positivement, au format E.164 (selon LibPhoneNumber).
[{...}].phoneCountryIso2VerifiedStringPays d'origine du numéro de téléphone vérifié positivement, au format ISO 3166-1 alpha-2 (selon LibPhoneNumber).Pays de résidence
[{...}].phoneCountryCodeNumberIndicatif d'appel du pays le plus probable.Préfixe téléphonique
[{...}].phoneCountryCodeAltNumberSecond indicatif d'appel du pays le plus probable.Préfixe téléphonique
[{...}].phoneCountryIso2StringPays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].phoneCountryIso2AltStringSecond pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].originCountryIso2StringPays de résidence le plus probable à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].originCountryIso2AltStringSecond pays de résidence le plus probable estimé à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].phoneNumberStringNuméro de téléphone soumis.
[{...}].verifiedBooleanIndique si le numéro de téléphone peut être vérifié positivement à l'aide de LibPhoneNumber.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Format Phone Number exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNamesWithPhoneNumbers":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Jamini","lastName":"Roy","phoneNumber":"09804201420"}]}'

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jamini",
      "lastName": "Roy",
      "phoneNumber": "09804201420"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jamini",
            "lastName": "Roy",
            "internationalPhoneNumberVerified": "+91 98042 01420",
            "phoneCountryIso2Verified": "IN",
            "phoneCountryCode": 91,
            "phoneCountryCodeAlt": 98,
            "phoneCountryIso2": "IN",
            "phoneCountryIso2Alt": "IR",
            "originCountryIso2": "BD",
            "originCountryIso2Alt": "ID",
            "phoneNumber": "09804201420",
            "verified": true,
            "score": 7.659341221254494
        }
    ]
}

Format Phone Number exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNamesWithPhoneNumbers\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Jamini\",\"lastName\":\"Roy\",\"phoneNumber\":\"09804201420\"}]}")
.asString();

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jamini",
      "lastName": "Roy",
      "phoneNumber": "09804201420"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jamini",
            "lastName": "Roy",
            "internationalPhoneNumberVerified": "+91 98042 01420",
            "phoneCountryIso2Verified": "IN",
            "phoneCountryCode": 91,
            "phoneCountryCodeAlt": 98,
            "phoneCountryIso2": "IN",
            "phoneCountryIso2Alt": "IR",
            "originCountryIso2": "BD",
            "originCountryIso2Alt": "ID",
            "phoneNumber": "09804201420",
            "verified": true,
            "score": 7.659341221254494
        }
    ]
}

Format Phone Number exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeBatch"

payload = {
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jamini",
      "lastName": "Roy",
      "phoneNumber": "09804201420"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jamini",
      "lastName": "Roy",
      "phoneNumber": "09804201420"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jamini",
            "lastName": "Roy",
            "internationalPhoneNumberVerified": "+91 98042 01420",
            "phoneCountryIso2Verified": "IN",
            "phoneCountryCode": 91,
            "phoneCountryCodeAlt": 98,
            "phoneCountryIso2": "IN",
            "phoneCountryIso2Alt": "IR",
            "originCountryIso2": "BD",
            "originCountryIso2Alt": "ID",
            "phoneNumber": "09804201420",
            "verified": true,
            "score": 7.659341221254494
        }
    ]
}

Format Phone Number exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jamini",
      "lastName": "Roy",
      "phoneNumber": "09804201420"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jamini",
      "lastName": "Roy",
      "phoneNumber": "09804201420"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jamini",
            "lastName": "Roy",
            "internationalPhoneNumberVerified": "+91 98042 01420",
            "phoneCountryIso2Verified": "IN",
            "phoneCountryCode": 91,
            "phoneCountryCodeAlt": 98,
            "phoneCountryIso2": "IN",
            "phoneCountryIso2Alt": "IR",
            "originCountryIso2": "BD",
            "originCountryIso2Alt": "ID",
            "phoneNumber": "09804201420",
            "verified": true,
            "score": 7.659341221254494
        }
    ]
}
  • Coût: 11 crédits par nom.
  • Description : Détermine le préfixe téléphonique le plus probable, le pays de résidence et le format d'un numéro de téléphone en utilisant un prénom, un nom de famille et un numéro de téléphone.
information

Pour les requêtes avec une méthode GET, tous les paramètres sont requis. Pour plus de facilité dans l'utilisation de nos requêtes, nous recommandons d'utiliser la méthode POST.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCode/{firstName}/{lastName}/{phoneNumber}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom du propriétaire du numéro de téléphone.
lastNameStringRequisNom de famille du propriétaire du numéro de téléphone.
phoneNumberStringRequisNuméro de téléphone, formaté ou non formaté.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
internationalPhoneNumberVerifiedStringNuméro de téléphone vérifié positivement, au format E.164 (selon LibPhoneNumber).
phoneCountryIso2VerifiedStringPays d'origine du numéro de téléphone vérifié positivement, au format ISO 3166-1 alpha-2 (selon LibPhoneNumber).Pays de résidence
phoneCountryCodeNumberIndicatif d'appel du pays le plus probable.Préfixe téléphonique
phoneCountryCodeAltNumberSecond indicatif d'appel du pays le plus probable.Préfixe téléphonique
phoneCountryIso2StringPays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
phoneCountryIso2AltStringSecond pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
originCountryIso2StringPays de résidence le plus probable à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
originCountryIso2AltStringSecond pays de résidence le plus probable estimé à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
phoneNumberStringNuméro de téléphone soumis.
verifiedBooleanIndique si le numéro de téléphone peut être vérifié positivement à l'aide de LibPhoneNumber.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Format Phone Number exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCode/Jamini/Roy/09804201420 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Jamini",
    "lastName": "Roy",
    "internationalPhoneNumberVerified": "+91 98042 01420",
    "phoneCountryIso2Verified": "IN",
    "phoneCountryCode": 91,
    "phoneCountryCodeAlt": 98,
    "phoneCountryIso2": "IN",
    "phoneCountryIso2Alt": "IR",
    "originCountryIso2": "BD",
    "originCountryIso2Alt": "ID",
    "phoneNumber": "09804201420",
    "verified": true,
    "score": 7.659341221254494
}

Format Phone Number exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCode/Jamini/Roy/09804201420")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Jamini",
    "lastName": "Roy",
    "internationalPhoneNumberVerified": "+91 98042 01420",
    "phoneCountryIso2Verified": "IN",
    "phoneCountryCode": 91,
    "phoneCountryCodeAlt": 98,
    "phoneCountryIso2": "IN",
    "phoneCountryIso2Alt": "IR",
    "originCountryIso2": "BD",
    "originCountryIso2Alt": "ID",
    "phoneNumber": "09804201420",
    "verified": true,
    "score": 7.659341221254494
}

Format Phone Number exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCode/Jamini/Roy/09804201420"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Jamini",
    "lastName": "Roy",
    "internationalPhoneNumberVerified": "+91 98042 01420",
    "phoneCountryIso2Verified": "IN",
    "phoneCountryCode": 91,
    "phoneCountryCodeAlt": 98,
    "phoneCountryIso2": "IN",
    "phoneCountryIso2Alt": "IR",
    "originCountryIso2": "BD",
    "originCountryIso2Alt": "ID",
    "phoneNumber": "09804201420",
    "verified": true,
    "score": 7.659341221254494
}

Format Phone Number exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCode/Jamini/Roy/09804201420", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Jamini",
    "lastName": "Roy",
    "internationalPhoneNumberVerified": "+91 98042 01420",
    "phoneCountryIso2Verified": "IN",
    "phoneCountryCode": 91,
    "phoneCountryCodeAlt": 98,
    "phoneCountryIso2": "IN",
    "phoneCountryIso2Alt": "IR",
    "originCountryIso2": "BD",
    "originCountryIso2Alt": "ID",
    "phoneNumber": "09804201420",
    "verified": true,
    "score": 7.659341221254494
}

Formater Numéro Téléphone (Geo)

Prefix téléphonique à partir de prénom (optionnel), nom de famille (optionnel), numéro de téléphone , code du pays .

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Teniola",
    "lastName": "Apata",
    "internationalPhoneNumberVerified": "+234 818 647 2651",
    "phoneCountryIso2Verified": "NG",
    "phoneCountryCode": 234,
    "phoneCountryCodeAlt": 62,
    "phoneCountryIso2": "NG",
    "phoneCountryIso2Alt": "ID",
    "originCountryIso2": "NG",
    "originCountryIso2Alt": "CI",
    "phoneNumber": "08186472651",
    "verified": true,
    "score": 2.362918055640346
}

Formater numéro Téléphone (Geo) améliore la fonctionnalité de base Formater numéro Téléphone en incorporant le contexte local pour une précision améliorée. Elle analyse un prénom, nom de famille et numéro de téléphone pour retourner le préfixe international le plus probable, le pays d'origine et le numéro de téléphone correctement formaté.

  • Coût: 11 crédits par nom.
  • Description : Détermine les préfixes téléphonique, les pays de résidence et les formats d'un numéro de téléphone à partir d'un ensemble de prénoms, noms de famille, numéros de téléphone et de leur contexte local (jusqu'à 100).
  • Plus d'informations sur : Formater Numéro Téléphone (Geo)

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeoBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Corps de la requête
NomTypeRequisDescription
personalNamesWithPhoneNumbersArray of objectsRequisUne liste de prénoms, noms de famille et numéros de téléphone.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom du propriétaire du numéro de téléphone.
[{...}].lastNameStringOptionelNom de famille du propriétaire du numéro de téléphone.
[{...}].phoneNumberStringRequisNuméro de téléphone, formaté ou non formaté.
[{...}].countryIso2StringRequisPays d'origine le plus probable, au format ISO 3166-1 alpha-2.
[{...}].countryIso2AltStringOptionelSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesWithPhoneNumbersArray of objectsNuméros de téléphone formatés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].internationalPhoneNumberVerifiedStringNuméro de téléphone vérifié positivement, au format E.164 (selon LibPhoneNumber).
[{...}].phoneCountryIso2VerifiedStringPays d'origine du numéro de téléphone vérifié positivement, au format ISO 3166-1 alpha-2 (selon LibPhoneNumber).Pays de résidence
[{...}].phoneCountryCodeNumberIndicatif d'appel du pays le plus probable.Préfixe téléphonique
[{...}].phoneCountryCodeAltNumberSecond indicatif d'appel du pays le plus probable.Préfixe téléphonique
[{...}].phoneCountryIso2StringPays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].phoneCountryIso2AltStringSecond pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].originCountryIso2StringPays de résidence le plus probable à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].originCountryIso2AltStringSecond pays de résidence le plus probable estimé à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].phoneNumberStringNuméro de téléphone soumis.
[{...}].verifiedBooleanIndique si le numéro de téléphone peut être vérifié positivement à l'aide de LibPhoneNumber.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Format Phone Number Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNamesWithPhoneNumbers":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Teniola","lastName":"Apata","phoneNumber":"08186472651","countryIso2":"NG","countryIso2Alt":"CI"}]}'

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Teniola",
      "lastName": "Apata",
      "phoneNumber": "08186472651",
      "countryIso2": "NG",
      "countryIso2Alt": "CI"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Teniola",
            "lastName": "Apata",
            "internationalPhoneNumberVerified": "+234 818 647 2651",
            "phoneCountryIso2Verified": "NG",
            "phoneCountryCode": 234,
            "phoneCountryCodeAlt": 62,
            "phoneCountryIso2": "NG",
            "phoneCountryIso2Alt": "ID",
            "originCountryIso2": "NG",
            "originCountryIso2Alt": "CI",
            "phoneNumber": "08186472651",
            "verified": true,
            "score": 2.362918055640346
        }
    ]
}

Format Phone Number Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNamesWithPhoneNumbers\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Teniola\",\"lastName\":\"Apata\",\"phoneNumber\":\"08186472651\",\"countryIso2\":\"NG\",\"countryIso2Alt\":\"CI\"}]}")
.asString();

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Teniola",
      "lastName": "Apata",
      "phoneNumber": "08186472651",
      "countryIso2": "NG",
      "countryIso2Alt": "CI"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Teniola",
            "lastName": "Apata",
            "internationalPhoneNumberVerified": "+234 818 647 2651",
            "phoneCountryIso2Verified": "NG",
            "phoneCountryCode": 234,
            "phoneCountryCodeAlt": 62,
            "phoneCountryIso2": "NG",
            "phoneCountryIso2Alt": "ID",
            "originCountryIso2": "NG",
            "originCountryIso2Alt": "CI",
            "phoneNumber": "08186472651",
            "verified": true,
            "score": 2.362918055640346
        }
    ]
}

Format Phone Number Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeoBatch"

payload = {
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Teniola",
      "lastName": "Apata",
      "phoneNumber": "08186472651",
      "countryIso2": "NG",
      "countryIso2Alt": "CI"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Teniola",
      "lastName": "Apata",
      "phoneNumber": "08186472651",
      "countryIso2": "NG",
      "countryIso2Alt": "CI"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Teniola",
            "lastName": "Apata",
            "internationalPhoneNumberVerified": "+234 818 647 2651",
            "phoneCountryIso2Verified": "NG",
            "phoneCountryCode": 234,
            "phoneCountryCodeAlt": 62,
            "phoneCountryIso2": "NG",
            "phoneCountryIso2Alt": "ID",
            "originCountryIso2": "NG",
            "originCountryIso2Alt": "CI",
            "phoneNumber": "08186472651",
            "verified": true,
            "score": 2.362918055640346
        }
    ]
}

Format Phone Number Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Teniola",
      "lastName": "Apata",
      "phoneNumber": "08186472651",
      "countryIso2": "NG",
      "countryIso2Alt": "CI"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNamesWithPhoneNumbers": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Teniola",
      "lastName": "Apata",
      "phoneNumber": "08186472651",
      "countryIso2": "NG",
      "countryIso2Alt": "CI"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNamesWithPhoneNumbers": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Teniola",
            "lastName": "Apata",
            "internationalPhoneNumberVerified": "+234 818 647 2651",
            "phoneCountryIso2Verified": "NG",
            "phoneCountryCode": 234,
            "phoneCountryCodeAlt": 62,
            "phoneCountryIso2": "NG",
            "phoneCountryIso2Alt": "ID",
            "originCountryIso2": "NG",
            "originCountryIso2Alt": "CI",
            "phoneNumber": "08186472651",
            "verified": true,
            "score": 2.362918055640346
        }
    ]
}
  • Coût: 11 crédits par nom.
  • Description : Détermine le préfixe téléphonique le plus probable, le pays de résidence et le format d'un numéro de téléphone en utilisant un prénom, un nom de famille, un numéro de téléphone et un contexte géographique.
information

Pour les requêtes avec une méthode GET, tous les paramètres sont requis. Pour plus de facilité dans l'utilisation de nos requêtes, nous recommandons d'utiliser la méthode POST.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeo/{firstName}/{lastName}/{phoneNumber}/{countryIso2}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom du propriétaire du numéro de téléphone.
lastNameStringRequisNom de famille du propriétaire du numéro de téléphone.
phoneNumberStringRequisNuméro de téléphone, formaté ou non formaté.
countryIso2StringRequisPays d'origine le plus probable, au format ISO 3166-1 alpha-2.
countryIso2AltStringRequisSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
internationalPhoneNumberVerifiedStringNuméro de téléphone vérifié positivement, au format E.164 (selon LibPhoneNumber).
phoneCountryIso2VerifiedStringPays d'origine du numéro de téléphone vérifié positivement, au format ISO 3166-1 alpha-2 (selon LibPhoneNumber).Pays de résidence
phoneCountryCodeNumberIndicatif d'appel du pays le plus probable.Préfixe téléphonique
phoneCountryCodeAltNumberSecond indicatif d'appel du pays le plus probable.Préfixe téléphonique
phoneCountryIso2StringPays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
phoneCountryIso2AltStringSecond pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2.Pays de résidence
originCountryIso2StringPays de résidence le plus probable à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
originCountryIso2AltStringSecond pays de résidence le plus probable estimé à partir du nom, au format ISO 3166-1 alpha-2.Pays d'origine
phoneNumberStringNuméro de téléphone soumis.
verifiedBooleanIndique si le numéro de téléphone peut être vérifié positivement à l'aide de LibPhoneNumber.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Format Phone Number Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeo/Teniola/Apata/08186472651/NG \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Teniola",
    "lastName": "Apata",
    "internationalPhoneNumberVerified": "+234 818 647 2651",
    "phoneCountryIso2Verified": "NG",
    "phoneCountryCode": 234,
    "phoneCountryCodeAlt": 62,
    "phoneCountryIso2": "NG",
    "phoneCountryIso2Alt": "ID",
    "originCountryIso2": "NG",
    "originCountryIso2Alt": "CI",
    "phoneNumber": "08186472651",
    "verified": true,
    "score": 2.362918055640346
}

Format Phone Number Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeo/Teniola/Apata/08186472651/NG")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Teniola",
    "lastName": "Apata",
    "internationalPhoneNumberVerified": "+234 818 647 2651",
    "phoneCountryIso2Verified": "NG",
    "phoneCountryCode": 234,
    "phoneCountryCodeAlt": 62,
    "phoneCountryIso2": "NG",
    "phoneCountryIso2Alt": "ID",
    "originCountryIso2": "NG",
    "originCountryIso2Alt": "CI",
    "phoneNumber": "08186472651",
    "verified": true,
    "score": 2.362918055640346
}

Format Phone Number Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeo/Teniola/Apata/08186472651/NG"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Teniola",
    "lastName": "Apata",
    "internationalPhoneNumberVerified": "+234 818 647 2651",
    "phoneCountryIso2Verified": "NG",
    "phoneCountryCode": 234,
    "phoneCountryCodeAlt": 62,
    "phoneCountryIso2": "NG",
    "phoneCountryIso2Alt": "ID",
    "originCountryIso2": "NG",
    "originCountryIso2Alt": "CI",
    "phoneNumber": "08186472651",
    "verified": true,
    "score": 2.362918055640346
}

Format Phone Number Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeo/Teniola/Apata/08186472651/NG", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Teniola",
    "lastName": "Apata",
    "internationalPhoneNumberVerified": "+234 818 647 2651",
    "phoneCountryIso2Verified": "NG",
    "phoneCountryCode": 234,
    "phoneCountryCodeAlt": 62,
    "phoneCountryIso2": "NG",
    "phoneCountryIso2Alt": "ID",
    "originCountryIso2": "NG",
    "originCountryIso2Alt": "CI",
    "phoneNumber": "08186472651",
    "verified": true,
    "score": 2.362918055640346
}

Section suivante

API Administration – Gérez votre compte et clés API