Namsor

Documentation d'API

Namsor a développé une technologie de vérification des noms, capable de créer une analyse complète grâce à un traitement multiple. Notre API peut classer les noms par origine, par ethnicité, par diaspora, par pays de résidence, par sexe, et prend en charge de nombreuses écritures*.

Introduction

À propos

Requêtes et réponses d'API

  • Tous les points de terminaison renvoient un JSON contenant soit un objet, soit un tableau d'objets imbriqué.
  • Actuellement, certains points de terminaison de l'API NamSor utilisent des structures d'objets imbriquées dans leur corps de requête et/ou leurs réponses, veuillez vous référer à l'exemple de code correspondant.
  • Sachez que les données dans les exemples de code ont été encodées en URL dans les caractères de code ASCII correspondants si nécessaire, par exemple 谢晓亮 est remplacé par %E8%B0%A2%E6%99%93% E4%BA%AE. Les URL ne peuvent pas contenir d'espaces ni de caractères non ASCII. Lorsque vous envoyez des requêtes GET à l'API, utilisez le codage d'URL pour convertir les caractères non ASCII dans un format pouvant être transmis sur Internet.

Confidentialité des données

Par défaut, l'algorithme d'apprentissage automatique de Namsor peut améliorer l'évaluation des données en fonction des entrées de données et stocke les journaux des demandes soumises. Vous pouvez modifier ces paramètres soit dans votre compte utilisateur, soit en appelant les points de terminaison API dédiés. Tous les journaux de données sont sécurisés à l'aide du cryptage AES avant d'être stockés.

Si vous souhaitez désactiver l'apprentissage automatique en fonction de vos soumissions, veuillez définir learnable sur false dans la section "Protection de la vie privée" à la page Mon compte. Lorsqu'il est défini sur false pour une clé API, les données traitées à l'aide de cette clé n'alimenteront pas l'algorithme d'apprentissage automatique.

Si vous souhaitez désactiver l'historique d'utilisation du service, veuillez définir anonymized sur true dans la section "Protection de la vie privée" à la page Mon compte. Lorsqu'il est défini sur true pour une clé API, les données traitées à l'aide de cette clé seront anonymisées de manière irréversible à l'aide du cryptage SHA. Notez que le traitement intelligent des requêtes redondantes fonctionnera toujours même si vos données sont anonymisées.

Authentication

Création de clé d'API

Les comptes clients sont communs à tous les sites du groupe Namsor. Pour créer une clé API, visitez Namsor ou un autre site du groupe Namsor et créer un compte. Accédez à la page d'informations sur le compte pour récupérer votre clé API. Votre compte nouvellement créé est livré avec 500 crédits gratuits que vous pouvez utiliser immédiatement avec l'un des outils de Namsor : API, processeur de fichiers CSV et Excel ou outils de développement.

Installation clé d'API

Votre clé API doit être définie dans l'en-tête de votre requête à l'aide de la propriété X-API-KEY. Veuillez vous référer aux exemples de code fournis pour une installation correcte de la clé.

information

Vous devez remplacer your-api-key par votre clé API Namsor.

Crédits

Que sont les crédits

Nous utilisons un système de crédit pour suivre l'utilisation de nos services. Chaque plan est livré avec une quantité mensuelle de crédits données et un prix correspondant. Le plan d'abonnement gratuit de base vous accorde 500 crédits mais d'autres plans sont disponibles au cas où vous auriez des exigences plus élevées. À titre d'exemple, avec 500 crédits vous pouvez soit :

  • Traiter 50 noms pour déterminer leurs origines.
  • Traiter 25 noms pour déterminer leurs diasporas.
  • Transliterer 500 noms Japonais.
  • Traitez 50 noms pour déterminer leur pays de résidence.
  • Traitez 500 noms pour déterminer leur sexe.
information

Les routes d'administration sont gratuites.

Tolérance des opérations répétées

Notre API propose un traitement intelligent et ne facturera pas l'analyse de données identiques (jusqu'à 20 fois). Par exemple, si vous soumettez le même nom complet 5 fois afin de déduire son origine, vous ne serez facturé que 1 crédit.

Limite flexible vs limite stricte

Dans votre compte utilisateur, vous pouvez définir deux types de limites d'utilisation du crédit :

  • Une limite souple qui déclenchera une notification par e-mail lorsqu'elle sera atteinte.
  • Une limite stricte qui déclenchera une notification par e-mail et bloquera la clé API lorsqu'elle sera atteinte.

Suivre l'utilisation

Il existe deux façons de suivre l'utilisation de votre crédit : vérifiez les graphiques fournis dans votre compte utilisateur ou interrogez les itinéraires d'administration appropriés (utilisation de l'API, historique de l'utilisation de l'API et agrégat de l'historique de l'utilisation de l'API).

Erreurs

L'API NamSor utilise les codes d'erreur suivants :

  • 401Non autoriséClé API manquante ou incorrecte.
  • 403InterditLimite API atteinte ou clé API désactivée.
  • 404IntrouvableL'itinéraire spécifié est introuvable.
  • 500Erreur de serveur interneErreur de serveur. Réessayez plus tard.

Explicabilité des Résultats

L'API de Namsor offre la possibilité d'obtenir une explicabilité détaillée sur la manière dont l'intelligence artificielle est parvenue à ses résultats pour une requête donnée. En activant cette option, un champ supplémentaire est inclus dans la réponse de l'API, fournissant une explication en code Python du processus suivi par l'IA.

Important

  • Coût supplémentaire : L'activation de l'explicabilité entraîne un coût additionnel de 50 crédits par nom traité.
  • Format de l'explication : L'explication retournée est sous forme de code Python. Pour une utilisation optimale, il est recommandé de supprimer les tabulations et les retours chariot afin que le code soit exploitable.

Comment activer l'explicabilité :

  • Contactez l'équipe Namsor: Avant d'utiliser cette fonctionnalité, veuillez contacter notre équipe pour activer l'option d'explicabilité sur votre compte client.
  • Configurer la requête : Ajoutez le header suivant à votre requête API :
X-OPTION-EXPLANABILITY: true

En suivant ces étapes, chaque requête inclura désormais une explication détaillée du résultat, vous permettant de comprendre en profondeur le fonctionnement de notre intelligence artificielle spécialisée en onomastique.

Cas d'utilisation de l'IA Act

L'API Namsor peut être un outil essentiel pour se conformer aux réglementations nationales ou supranationales visant à prévenir les résultats biaisés et les effets discriminatoires en intelligence artificielle. Namsor est capable de déduire des catégories spéciales de données personnelles à partir des noms afin d'estimer le risque de biais algorithmiques liés au genre, à la race, aux antécédents culturels/linguistiques, à l'ethnicité ou au pays d'origine.

L'IA Act européen introduit une nouvelle exception concernant les « données sensibles » pour protéger les droits des citoyens contre la discrimination pouvant découler de biais dans les systèmes d'IA. Dans le but d'assurer la détection et la correction des biais dans les systèmes d'IA à haut risque, il permet le traitement de catégories spéciales de données personnelles, en raison d'un intérêt public substantiel.

L'option d'explicabilité de Namsor est conçue pour fournir une formule mathématique fermée qui inclut l'explication complète de la classification des noms (avec à la fois les caractéristiques des données d'entraînement et les formules complètes du modèle). Cela peut être stocké à des fins d'audit dans les algorithmes décisionnels d'IA.

Pour protéger la propriété intellectuelle de Namsor, nous exigeons une documentation spécifique et un accord de non-divulgation (NDA) signé avant d'activer cette option.

Origine des noms

Namsor vous aide à trouver des informations détaillées sur l'origine d'un nom en établissant le pays d'origine d'un nom, l'ethnie, la diaspora et le pays de residence. Nous fournissons également une API d'évaluation des corridors, pour vérifier les informations générales sur les interactions internationales.

Origine

La fonctionnalité Origine analyse un prénom et/ou un nom de famille pour identifier le pays d'origine avec une précision légèrement améliorée par rapport à la fonctionnalité Origine Nom Complet. L'ajout d'un prénom et d'un nom augmente la précision de l'estimation.
La fonctionnalité renvoie la région d'origine, le pays d'origine et une liste des 10 pays d'origine les plus probables. Chaque pays d'origine estimé est accompagné d'une probabilité calibrée.

Notez que le fonctionnalité Diaspora peut être mieux adaptée aux pays multiculturels, tels que les États-Unis, le Canada, l'Australie, la Nouvelle-Zélande et d'autres "melting-pots".

  • Description : Renvoie le pays d'origine le plus probable d'un maximum de 100 prénoms et/ou noms de famille.
  • Precision :Jauge de précision
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/originBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets renseignés avec leurs pays d'origine.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].countryOriginStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].countryOriginAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].countriesOriginTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].regionOriginStringRégion d'origine la plus probable.Régions
[{...}].topRegionOriginStringRégion d'origine la plus probable (classification alternative).Régions
[{...}].subRegionOriginStringSous-région d'origine la plus probable.Sous régions
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].religionStatsArray of objectsStatistiques religieuses pour le pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine le plus probable (countryOrigin).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour le second pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays d'origine le plus probable (countryOriginAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays d'origine le plus probable (countryOriginAlt).

Exemples d'intégration:

Name Origin exemple de code pour shell:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}
information

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

  • Description : Renvoie le pays d'origine le plus probable à partir d'un prénom et/ou d'un nom de famille.
  • Precision :Jauge de précision
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/origin/{firstName}/{lastName}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
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é.
countryOriginStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
countryOriginAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
countriesOriginTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
regionOriginStringRégion d'origine la plus probable.Régions
topRegionOriginStringRégion d'origine la plus probable (classification alternative).Régions
subRegionOriginStringSous-région d'origine d'origine la plus probable.Sous régions
probabilityCalibratedNumberLa probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
religionStatsArray of objectsStatistiques religieuses pour le pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine le plus probable (countryOrigin).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin).
religionStatsAltArray of objectsStatistiques religieuses pour le second pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays d'origine le plus probable (countryOriginAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays d'origine le plus probable (countryOriginAlt).

Exemples d'intégration:

Name Origin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring")
.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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring"

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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring", {
  "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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Origine Nom Complet

La fonctionnalité Origine Nom Complet analyse nom complet non divisé (prénom et nom de famille) pour identifier le pays d'origine.
La fonctionnalité renvoie la région d'origine, le pays d'origine et une liste des 10 pays d'origine les plus probables. Chaque pays d'origine estimé est accompagné d'une probabilité calibrée.

Notez que le fonctionnalité Diaspora peut être mieux adaptée aux pays multiculturels, tels que les États-Unis, le Canada, l'Australie, la Nouvelle-Zélande et d'autres "melting-pots".

information

Si le nom de famille et le prénom sont clairement identifiables, la fonction Origine sera légèrement plus précise.

  • Description : Renvoie le pays d'origine le plus probable d'un maximum de 100 noms complets non divisés.
  • Precision :Jauge de précision
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine Nom Complet.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/originFullBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés avec leurs pays d'origine.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet non divisé (prénom et nom de famille).
[{...}].countryOriginStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].countryOriginAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].countriesOriginTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].regionOriginStringRégion d'origine la plus probable.Régions
[{...}].topRegionOriginStringRégion d'origine la plus probable (classification alternative).Régions
[{...}].subRegionOriginStringSous-région d'origine la plus probable.Sous régions
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].religionStatsArray of objectsStatistiques religieuses pour le pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine le plus probable (countryOrigin).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour le second pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays d'origine le plus probable (countryOriginAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays d'origine le plus probable (countryOriginAlt).

Exemples d'intégration:

Full Name Origin exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/originFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Keith Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

Full Name Origin exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

Full Name Origin exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

Full Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/originFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}
information

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

  • Description : Renvoie le pays d'origine le plus probable à partir d'un nom complet non divisé.
  • Precision :Jauge de précision
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine Nom Complet.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/{name}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom complet renseigné.
countryOriginStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
countryOriginAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
countriesOriginTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
regionOriginStringRégion d'origine la plus probable.Régions
topRegionOriginStringRégion d'origine la plus probable (classification alternative).Régions
subRegionOriginStringSous-région d'origine d'origine la plus probable.Sous régions
probabilityCalibratedNumberLa probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
religionStatsArray of objectsStatistiques religieuses pour le pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine le plus probable (countryOrigin).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin).
religionStatsAltArray of objectsStatistiques religieuses pour le second pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays d'origine le plus probable (countryOriginAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays d'origine le plus probable (countryOriginAlt).

Exemples d'intégration:

Full Name Origin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

Full Name Origin exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/Keith%20Haring")
.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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

Full Name Origin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/Keith%20Haring"

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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

Full Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/Keith%20Haring", {
  "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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

Diaspora

La fonctionnalité Diaspora analyse un nom pour identifier l'ethnie/diaspora la plus probable avec une précision légèrement améliorée par rapport à la fonctionnalité Diaspora Nom Complet. L'ajout d'un prénom, d'un nom de famille et d'un pays de résidence augmente la précision de la diaspora estimée.
La fonctionnalité renvoie l'ethnie/diaspora la plus probable et un top 10 des ethnies classées du plus probable au moins probable. Chaque ethnie renvoyée est accompagnée d'une probabilité calibrée.

  • Description : Estime les ethnicités/diasporas les plus vraisemblable d'un ensemble de prénoms, d'un noms de famille et de pays de résidence.
  • Precision :Jauge de précision
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringRequisNom de famille.
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis avec leurs ethnies estimées.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].ethnicityAltStringSeconde ethnie la plus probable.Ethnicités et diasporas
[{...}].ethnicityStringEthnie la plus probable.Ethnicités et diasporas
[{...}].liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
[{...}].countryIso2StringSubmitted Pays de résidence, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].ethnicitiesTopArrayTop 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].religionStatsArray of objectsStatistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion au sein de la diaspora la plus probable (ethnicity).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour la seconde diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion au sein de la seconde diaspora la plus probable (ethnicityAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion au sein de la seconde diaspora la plus probable (ethnicityAlt).

Exemples d'intégration:

Name Diaspora exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"0d7d6417-0bbb-4205-951d-b3473f605b56","firstName":"Keith","lastName":"Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"0d7d6417-0bbb-4205-951d-b3473f605b56\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}
information

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

  • Description : Détermine l'ethnicité/diaspora la plus vraisemblable à partir d'un prénom, d'un nom de famille et d'un pays de résidence.
  • Precision :Jauge de précision
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/{countryIso2}/{firstName}/{lastName}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
ethnicityAltStringSeconde ethnie la plus probable.Ethnicités et diasporas
ethnicityStringEthnie la plus probable.Ethnicités et diasporas
liftedBooleanIndique si le résultat du champ "ethnicity" est basé uniquement sur l'apprentissage automatique ou s'il est davantage considéré comme un fait connu par une règle spécifique au pays.
countryIso2StringPays de résidence, au format ISO 3166-1 alpha-2.Pays de résidence
ethnicitiesTopArrayTop 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
probabilityCalibratedNumberLa probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
religionStatsArray of objectsStatistiques religieuses pour le pays d'origine de la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine de la diaspora la plus probable (ethnicity).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine de la diaspora la plus probable (ethnicity).
religionStatsAltArray of objectsStatistiques religieuses pour le pays d'origine de la seconde diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine de la seconde diaspora la plus probable (ethnicityAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine de la seconde diaspora la plus probable (ethnicityAlt).

Exemples d'intégration:

Name Diaspora exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring")
.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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring"

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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring", {
  "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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Diaspora Nom Complet

La fonctionnalité Diaspora Nom Complet analyse un nom complet non divisé (prénom et nom de famille) pour identifier l'ethnie/diaspora la plus probable.
La fonctionnalité renvoie l'ethnie/diaspora la plus probable et un top 10 des ethnies classées du plus probable au moins probable. Chaque ethnie renvoyée est accompagnée d'une probabilité calibrée.

information

Si le nom de famille et le prénom sont clairement identifiables, la fonction Diaspora sera légèrement plus précise.

  • Description : Estime les ethnicités/diasporas les plus vraisemblable d'un ensemble de noms complets non divisés et de pays de résidence.
  • Precision :Jauge de précision
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora Nom Complet.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis avec leurs ethnies estimées.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].ethnicityAltStringSeconde ethnie la plus probable.Ethnicités et diasporas
[{...}].ethnicityStringEthnie la plus probable.Ethnicités et diasporas
[{...}].liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
[{...}].countryIso2StringSubmitted Pays de résidence, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].ethnicitiesTopArrayTop 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].religionStatsArray of objectsStatistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion au sein de la diaspora la plus probable (ethnicity).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour la seconde diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion au sein de la seconde diaspora la plus probable (ethnicityAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion au sein de la seconde diaspora la plus probable (ethnicityAlt).

Exemples d'intégration:

Full Name Diaspora exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"0d7d6417-0bbb-4205-951d-b3473f605b56","name":"Keith Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

Full Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"0d7d6417-0bbb-4205-951d-b3473f605b56\",\"name\":\"Keith Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

Full Name Diaspora exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

Full Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}
information

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

  • Description : Détermine l'ethnicité/diaspora la plus vraisemblable à partir d'un nom complet non divisé et d'un pays de résidence.
  • Precision :Jauge de précision
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora Nom Complet.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/{countryIso2}/{name}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
ethnicityAltStringSeconde ethnie la plus probable.Ethnicités et diasporas
ethnicityStringEthnie la plus probable.Ethnicités et diasporas
liftedBooleanIndique si le résultat du champ "ethnicity" est basé uniquement sur l'apprentissage automatique ou s'il est davantage considéré comme un fait connu par une règle spécifique au pays.
countryIso2StringPays de résidence, au format ISO 3166-1 alpha-2.Pays de résidence
ethnicitiesTopArrayTop 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
probabilityCalibratedNumberLa probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
religionStatsArray of objectsStatistiques religieuses pour le pays d'origine de la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine de la diaspora la plus probable (ethnicity).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine de la diaspora la plus probable (ethnicity).
religionStatsAltArray of objectsStatistiques religieuses pour le pays d'origine de la seconde diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine de la seconde diaspora la plus probable (ethnicityAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine de la seconde diaspora la plus probable (ethnicityAlt).

Exemples d'intégration:

Full Name Diaspora exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

Full Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/Keith%20Haring")
.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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

Full Name Diaspora exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/Keith%20Haring"

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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

Full Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/Keith%20Haring", {
  "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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

Ethnie US

La fonctionnalité Ethnie US analyse un prénom et ou un nom de famille pour identifier l'ethnie 'raciale' US la plus probable avec une précision légèrement améliorée par rapport à la fonctionnalité Ethnie US Nom Complet. L'ajout d'un prénom, d'un nom de famille et d'un pays de résidence augmente la précision de l'ethnie 'raciale' américaine déterminée.
La fonction renvoie l'ethnie 'raciale' US la plus probable et une liste des ethnies 'raciales' US triées du plus probable au moins probable. Chaque ethnie 'raciale' estimée est accompagnée d'une probabilité calibrée.

L'ethnie 'raciale' US est une catégorisation officielle du bureau du recensement des États-Unis

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés enrichis de leur ethnie 'raciale'.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"85dd5f48-b9e1-4019-88ce-ccc7e56b763f","firstName":"Keith","lastName":"Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"85dd5f48-b9e1-4019-88ce-ccc7e56b763f\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

Name US Race exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/{firstName}/{lastName}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring")
.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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Name US Race exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring"

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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring", {
  "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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Ethnie US (ZIP)

La fonctionnalité Ethnie US (ZIP) analyse un prénom et/ou un nom de famille pour identifier l'ethnie 'raciale' US la plus probable avec une précision améliorée par rapport à la fonctionnalité de base Ethnie US. L'ajout d'un prénom, d'un nom de famille et d'un pays de résidence augmente la précision de l'ethnie 'raciale' américaine déterminée.
La fonction renvoie l'ethnie 'raciale' US la plus probable et une liste des ethnies 'raciales' US triées du plus probable au moins probable. Chaque ethnie 'raciale' estimée est accompagnée d'une probabilité calibrée.

L'ethnie 'raciale' US est une catégorisation officielle du bureau du recensement des États-Unis

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms de personnes avec leur pays de résidence et leur code postal.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2.
[{...}].zipCodeStringRequisCode postal (5 chiffres) de résidence utilisé par le service postal des États-Unis (USPS).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés enrichis de leur ethnie 'raciale'.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race ZIP exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"728767f9-c5b2-4ed3-a071-828077f16552","firstName":"Keith","lastName":"Haring","countryIso2":"US","zipCode":"10019"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

Name US Race ZIP exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"728767f9-c5b2-4ed3-a071-828077f16552\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\",\"zipCode\":\"10019\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

Name US Race ZIP exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

Name US Race ZIP exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/{firstName}/{lastName}/{zipCode}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
zipCodeStringRequisCode postal (5 chiffres) de résidence utilisé par le service postal des États-Unis (USPS).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race ZIP exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Name US Race ZIP exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019")
.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": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Name US Race ZIP exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019"

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": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Name US Race ZIP exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019", {
  "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": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Ethnie US Nom Complet

La fonctionnalité Ethnie US Nom Complet analyse un nom pour identifier l'ethnie 'raciale' US la plus probable.
La fonction renvoie l'ethnie 'raciale' US la plus probable et une liste des ethnies 'raciales' US triées du plus probable au moins probable. Chaque ethnie 'raciale' estimée est accompagnée d'une probabilité calibrée.

L'ethnie 'raciale' US est une catégorisation officielle du bureau du recensement des États-Unis

information

Si le nom de famille et le prénom sont clairement identifiables, la fonction Ethnie US sera légèrement plus précise.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets renseignés enrichis de leur ethnie 'raciale'.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Full Name US Race exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"85dd5f48-b9e1-4019-88ce-ccc7e56b763f","name":"Keith Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}

Full Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"85dd5f48-b9e1-4019-88ce-ccc7e56b763f\",\"name\":\"Keith Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}

Full Name US Race exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}

Full Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/{name}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Full Name US Race exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Full Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/Keith%20Haring")
.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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Full Name US Race exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/Keith%20Haring"

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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Full Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/Keith%20Haring", {
  "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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Pays de Residence

La fonctionnalité Pays de Residence analyse un prénom et/ou un nom de famille pour identifier son pays de résidence avec une précision légèrement améliorée par rapport à la fonctionnalité Pays de Residence Nom Complet. L'ajout d'un prénom et d'un nom de famille augmente la précision du genre déterminé.
La fonctionnalité renvoie la région de résidence, le pays de résidence et une liste des 10 principaux pays de résidence, classés du plus probable au moins probable. Chaque pays de résidence renvoyé est accompagné d'une probabilité calibrée.

  • Description : Renvoie le pays de résidence le plus probable parmi 100 prénoms et/ou noms de famille.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Pays de Residence.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLnBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés avec leurs pays de résidence.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].countryStringPays de résidence le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].countryAltStringSecond pays de résidence le plsu vraisemblable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].regionStringRégion de résidence la plus probable.Régions
[{...}].topRegionStringRégion de résidence la plus probable (classification alternative).Régions
[{...}].subRegionStringSous-région de résidence la plus probable.Sous régions
[{...}].countriesTopArrayTop 10 des pays de résidence les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].religionStatsArray of objectsStatistiques religieuses pour le pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays de résidence le plus probable (country).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour le second pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays de résidence le plus probable (countryAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays de résidence le plus probable (countryAlt).

Exemples d'intégration:

Name Country exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLnBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4","firstName":"Keith","lastName":"Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

Name Country exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLnBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4\",\"firstName\":\"Keith\",\"lastName\":\"Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

Name Country exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

Name Country exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLnBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}
information

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

  • Description : Renvoie le pays de résidence le plus probable à partir d'un prénom et/ou d'un nom de famille.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Pays de Residence.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLn/{firstName}/{lastName}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
countryStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
countryAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
regionStringRégion d'origine la plus probable.Régions
topRegionStringRégion d'origine la plus probable (classification alternative).Régions
subRegionStringSous-région.Sous régions
countriesTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.
probabilityCalibratedNumberLa probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
religionStatsArray of objectsStatistiques religieuses pour le pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays de résidence le plus probable (country).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country).
religionStatsAltArray of objectsStatistiques religieuses pour le second pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays de résidence le plus probable (countryAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays de résidence le plus probable (countryAlt).

Exemples d'intégration:

Name Country exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLn/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

Name Country exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLn/Keith/Haring")
.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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

Name Country exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLn/Keith/Haring"

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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

Name Country exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLn/Keith/Haring", {
  "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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

Pays de Residence Nom Complet

La fonctionnalité Pays de Residence Nom Complet analyse un nom complet non divisé (prénom et nom de famille) pour identifier son pays de résidence.
La fonctionnalité renvoie la région de résidence, le pays de résidence et une liste des 10 principaux pays de résidence, classés du plus probable au moins probable. Chaque pays de résidence renvoyé est accompagné d'une probabilité calibrée.

information

Si le nom de famille et le prénom sont clairement identifiables, la fonction Pays de Residence sera légèrement plus précise.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets renseignés avec leurs pays de résidence.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].countryStringPays de résidence le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].countryAltStringSecond pays de résidence le plsu vraisemblable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].regionStringRégion de résidence la plus probable.Régions
[{...}].topRegionStringRégion de résidence la plus probable (classification alternative).Régions
[{...}].subRegionStringSous-région de résidence la plus probable.Sous régions
[{...}].countriesTopArrayTop 10 des pays de résidence les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].religionStatsArray of objectsStatistiques religieuses pour le pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays de résidence le plus probable (country).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour le second pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays de résidence le plus probable (countryAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays de résidence le plus probable (countryAlt).

Exemples d'intégration:

Full Name Country exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4","name":"Keith Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Full Name Country exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4\",\"name\":\"Keith Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Full Name Country exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Full Name Country exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/country/{name}
En-tête de requête
PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
countryStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
countryAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
regionStringRégion d'origine la plus probable.Régions
topRegionStringRégion d'origine la plus probable (classification alternative).Régions
subRegionStringSous-région.Sous régions
countriesTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.
probabilityCalibratedNumberLa probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
Optionnel : X-OPTION-RELIGION-STATS = True
religionStatsArray of objectsStatistiques religieuses pour le pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays de résidence le plus probable (country).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country).
religionStatsAltArray of objectsStatistiques religieuses pour le second pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays de résidence le plus probable (countryAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays de résidence le plus probable (countryAlt).

Exemples d'intégration:

Full Name Country exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Full Name Country exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring")
.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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Full Name Country exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring"

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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Full Name Country exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring", {
  "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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Corridor

La fonctionnalité Corridor analyse le prénom, le nom et le pays de résidence de deux personnes pour générer un rapport complet de l'interaction.

  • Description : Renvoie une analyse complète d'un ensemble d'interactions transfrontalières (jusqu'à 100) entre deux noms en utilisant leur contexte géographique. L'expéditeur est celui qui a initié l'interaction (from), tandis que le destinataire est celui destiné à recevoir l'interaction (to).
  • Coût : 20 crédits par nom.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
corridorFromToArray of objectsRequisUne liste de paires de noms, avec le code du pays (nameFrom -> nameTo).
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstLastNameGeoFromObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequis.
{...}.lastNameStringRequis.
{...}.countryIso2StringRequis.
[{...}].firstLastNameGeoToObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequis.
{...}.lastNameStringRequis.
{...}.countryIso2StringRequis.
Réponse
NomTypeDescriptionÉnumérateurs
corridorFromToArray of objectsUne liste de paires de noms classifiés.
[{...}].idStringIdentifiant unique.
[{...}].firstLastNameGeoFromGenderObjectDonnées de genre pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.likelyGenderString.Genres
{...}.genderScaleNumber.
{...}.scoreNumber.
{...}.probabilityCalibratedNumber.
[{...}].firstLastNameGeoToGenderObjectDonnées de genre pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.likelyGenderString.Genres
{...}.genderScaleNumber.
{...}.scoreNumber.
{...}.probabilityCalibratedNumber.
[{...}].firstLastNameGeoFromOriginObjectDonnées d'origine pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.countryOriginString.Pays d'origine
{...}.countryOriginAltString.Pays d'origine
{...}.countriesOriginTopArray.Pays d'origine
{...}.scoreNumber.
{...}.regionOriginString.Régions
{...}.topRegionOriginString.Régions
{...}.subRegionOriginString.Sous régions
{...}.probabilityCalibratedNumber.
{...}.probabilityAltCalibratedNumber.
[{...}].firstLastNameGeoToOriginObjectDonnées d'origine pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.countryOriginString.Pays d'origine
{...}.countryOriginAltString.Pays d'origine
{...}.countriesOriginTopArray.Pays d'origine
{...}.scoreNumber.
{...}.regionOriginString.Régions
{...}.topRegionOriginString.Régions
{...}.subRegionOriginString.Sous régions
{...}.probabilityCalibratedNumber.
{...}.probabilityAltCalibratedNumber.
[{...}].firstLastNameGeoFromDiasporaObjectDonnées de la diaspora pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.scoreNumber.
{...}.ethnicityAltString.Ethnicités et diasporas
{...}.ethnicityString.Ethnicités et diasporas
{...}.liftedBoolean.
{...}.countryIso2String.Pays de résidence
{...}.ethnicitiesTopArray.Ethnicités et diasporas
[{...}].firstLastNameGeoToDiasporaObjectDonnées de la diaspora pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.scoreNumber.
{...}.ethnicityAltString.Ethnicités et diasporas
{...}.ethnicityString.Ethnicités et diasporas
{...}.liftedBoolean.
{...}.countryIso2String.Pays de résidence
{...}.ethnicitiesTopArray.Ethnicités et diasporas

Exemples d'intégration:

Names Corridor exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"corridorFromTo":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstLastNameGeoFrom":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Ada","lastName":"Lovelace","countryIso2":"GB"},"firstLastNameGeoTo":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Nicolas","lastName":"Tesla","countryIso2":"US"}}]}'

Paramètre du corps :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

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

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}

Names Corridor exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"corridorFromTo\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstLastNameGeoFrom\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Ada\",\"lastName\":\"Lovelace\",\"countryIso2\":\"GB\"},\"firstLastNameGeoTo\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Nicolas\",\"lastName\":\"Tesla\",\"countryIso2\":\"US\"}}]}")
.asString();

Paramètre du corps :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

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

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}

Names Corridor exemple de code pour python:

import requests

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

payload = {
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}
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 :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

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

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}

Names Corridor exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
})
});

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 :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

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

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}
information

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

  • Description : Renvoie une analyse complète d'interactions transfrontalières entre deux noms en utilisant leur contexte géographique. L'expéditeur est celui qui a initié l'interaction (from) tandis que le destinataire est celui destiné à recevoir l'interaction (to).
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Corridor.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/{countryIso2}/{firstName}/{lastName}/{countryIso2}/{firstName}/{lastName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
countryIso2StringRequisPays d'origine de l'expéditeur, au format ISO 3166-1 alpha-2.
firstNameStringRequisPrénom de l'expéditeur.
lastNameStringRequisNom de famille de l'expéditeur.
countryIso2StringRequisPays d'origine du destinataire, au format ISO 3166-1 alpha-2.
firstNameStringRequisPrénom du destinataire.
lastNameStringRequisNom de famille du destinataire.
Réponse
NomTypeDescriptionÉnumérateurs
idStringIdentifiant unique.
firstLastNameGeoFromGenderObjectDonnées de genre pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.likelyGenderStringGenre le plus probable de l'expéditeur.Genres
{...}.genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
firstLastNameGeoToGenderObjectDonnées de genre pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.likelyGenderStringGenre le plus probable du destinataire.Genres
{...}.genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
firstLastNameGeoFromOriginObjectDonnées d'origine pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.countryOriginStringPays d'origine de l'expéditeur le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countryOriginAltStringSecond pays d'origine de l'expéditeur le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countriesOriginTopArrayTop 10 des pays d'origine de l'expéditeur les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.regionOriginStringRégion d'origine de l'expéditeur la plus probable.Régions
{...}.topRegionOriginStringRégion d'origine de l'expéditeur la plus probable (classification alternative).Régions
{...}.subRegionOriginStringSous-région d'origine de l'expéditeur la plus probable.Sous régions
{...}.probabilityCalibratedNumberLa probabilité calibrée pour 'countryOrigin' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
{...}.probabilityAltCalibratedNumberLa probabilité calibrée pour 'countryOrigin' ou 'countryOriginAlt' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
firstLastNameGeoToOriginObjectDonnées d'origine pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.countryOriginStringPays d'origine du destinataire le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countryOriginAltStringSecond pays d'origine du destinataire le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countriesOriginTopArrayTop 10 des pays d'origine du destinataire les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.regionOriginStringRégion d'origine du destinataire la plus probable.Régions
{...}.topRegionOriginStringRégion d'origine du destinataire la plus probable (classification alternative).Régions
{...}.subRegionOriginStringSous-région d'origine du destinataire la plus probable.Sous régions
{...}.probabilityCalibratedNumberLa probabilité calibrée pour 'countryOrigin' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
{...}.probabilityAltCalibratedNumberLa probabilité calibrée pour 'countryOrigin' ou 'countryOriginAlt' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
firstLastNameGeoFromDiasporaObjectDonnées de la diaspora pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.ethnicityAltStringSeconde ethnie de l'expéditeur la plus probable.Ethnicités et diasporas
{...}.ethnicityStringEthnie de l'expéditeur la plus probable.Ethnicités et diasporas
{...}.liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
{...}.countryIso2StringPays d'origine de l'expéditeur renseigné, au format ISO 3166-1 alpha-2.Pays de résidence
{...}.ethnicitiesTopArrayTop 10 des ethnies de l'expéditeur les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
firstLastNameGeoToDiasporaObjectDonnées de la diaspora pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.ethnicityAltStringSeconde ethnie du destinataire la plus probable.Ethnicités et diasporas
{...}.ethnicityStringEthnie du destinataire la plus probable.Ethnicités et diasporas
{...}.liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
{...}.countryIso2StringPays d'origine du destinataire renseigné, au format ISO 3166-1 alpha-2.Pays de résidence
{...}.ethnicitiesTopArrayTop 10 des ethnies du destinataire les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas

Exemples d'intégration:

Names Corridor exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Names Corridor exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Names Corridor exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla"

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 :

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Names Corridor exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla", {
  "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 :

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Genre depuis un nom

L'API de vérification de nom de Namsor peut vous aider à déterminer la probabilité qu'une personne soit un homme ou une femme en fonction de son prénom. Nous proposons de nombreuses options de traitement pour la détermination du genre, le nom peut être fourni : sous la forme d'un nom complet, sous la forme d'un prénom et d'un nom . En plus du nom, vous pouvez spécifier le pays d'origine pour améliorer la précision. Notre API prend également en charge les noms chinois, les noms japonais et un grand nombre d'alphabets supplémentaires*.

Genre

La fonctionnalité Genre analyse un prénom et un nom de famille (facultatif) pour identifier le genre le plus probable avec une précision légèrement améliorée par rapport à la fonctionnalité Genre Nom Complet. L'ajout d'un prénom et d'un nom augmente la précision du genre déterminé.
La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité estimée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom unisexe.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 prénoms et noms (facultatif).
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringRequisPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis genré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é.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"b590b04c-da23-4f2f-a334-aee384ee420a","firstName":"Keith","lastName":"Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}

Genderize Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"b590b04c-da23-4f2f-a334-aee384ee420a\",\"firstName\":\"Keith\",\"lastName\":\"Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}

Genderize Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}

Genderize Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}
information

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

  • Description : Estime le genre le plus probable à partir d'un prénom et d'un nom de famille.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/gender/{firstName}/{lastName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genderize Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring")
.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": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genderize Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring"

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": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genderize Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring", {
  "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": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genre (Geo)

La fonctionnalité Genre (Geo) analyse un prénom, un nom de famille (facultatif) et un pays de résidence pour identifier le genre le plus probable avec une précision améliorée par rapport à la fonctionnalité Genre. L'ajout d'un prénom et d'un nom de famille augmente la précision du genre estimé.
La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité. Si la probabilité estimée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom unisexe.

  • Description : Renvoie le genre le plus vraisemblable d'un maximum de 100 prénoms et noms de famille (facultatif) en utilisant leur contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre (Geo).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringRequisPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis genré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é.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"27fb45db-eddf-40d0-95c1-de9978a166b0","firstName":"Keith","lastName":"Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}

Genderize Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"27fb45db-eddf-40d0-95c1-de9978a166b0\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}

Genderize Name Geo exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}

Genderize Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}
information

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

  • Description : Estime le genre le plus probable à partir d'un prénom et d'un nom de famille, enrichi d'un contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre (Geo).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/{firstName}/{lastName}/{countryIso2}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
countryIso2StringRequisPays 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.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genderize Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US")
.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": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genderize Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US"

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": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genderize Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US", {
  "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": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genre Nom Complet

La fonctionnalité Genre Nom Complet analyse un nom complet non divisé (prénom et nom de famille) pour identifier le genre le plus probable.
La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité estimée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom non-genré.

information

Si le nom et le prénom sont clairement identifiables, la fonction Genre sera légèrement plus précise.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 noms complets non divisés.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels complets.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"0f472330-11a9-49ad-a0f5-bcac90a3f6bf","name":"Keith Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}

Genderize Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"0f472330-11a9-49ad-a0f5-bcac90a3f6bf\",\"name\":\"Keith Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}

Genderize Full Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}

Genderize Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genderize Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring")
.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": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genderize Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring"

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": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genderize Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring", {
  "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": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genre Nom Complet (Geo)

La fonctionnalité Genre Nom Complet (Geo) analyse un nom complet non divisé (prénom et nom de famille) accompagné d'un pays de résidence, afin d'identifier le genre le plus probable avec une meilleure précision que la fonctionnalité de base Genre Nom Complet. La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité renvoyée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom non-genré.

information

Si le nom et le prénom sont clairement identifiables, la fonction Genre Nom Geo sera légèrement plus précise.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 noms complets non divisés, en se basant sur un contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet (Geo).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f","name":"Keith Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}

Genderize Full Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f\",\"name\":\"Keith Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}

Genderize Full Name Geo exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}

Genderize Full Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}
information

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

  • Description : Identifie le genre le plus probable d'un nom complet non divisé, selon son contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet (Geo).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/{name}/{countryIso2}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
countryIso2StringRequisPays 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.
nameStringNom complet renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Genderize Full Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US")
.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": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Genderize Full Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US"

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": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Genderize Full Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US", {
  "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": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Type des noms

Namsor fournit une API spécialisée dans la détermination du type d'un nom propre. Elle est formée pour analyser les noms propres et déduire s'il s'agit de noms personnels (anthroponyme), de noms de marques (toponyme) ou de noms de lieux. Différenciez les individus des entreprises en fonction de leur nom afin d'automatiser les processus, d'évaluer les références aux noms ou d'obtenir une meilleure connaissance d'un public. Pour obtenir de meilleurs résultats, vous pouvez indiquer le pays d'origine du nom.

Type Nom

La fonctionnalité Type Nom analyse un nom propre pour déterminer s'il s'agit du nom d'une personne (anthroponyme), d'un nom géographique (toponyme), de l'alias d'une personne (pseudonyme), ou le nom d'une marque. Nous vous recommandons de soumettre le nom complet.

  • Description : Estime le type d'un ensemble de noms propres (jusqu'à 100). Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Type Nom.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
properNounsArray of objectsRequisUne liste de noms propres.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisUn nom propre (personne, marque, etc.).
Réponse
NomTypeDescriptionÉnumérateurs
properNounsArray of objectsUne liste de noms propres avec leur type estimé.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom propre renseigné.
[{...}].commonTypeStringType le plus probable du nom propre.Type du nom
[{...}].commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"properNouns":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Zippo"}]}'

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}

Name Type exemple de code pour java:

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

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}

Name Type exemple de code pour python:

import requests

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

payload = {
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}
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 :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}

Name Type exemple de code pour javascript:

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

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 :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}
information

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

  • Description : Détermine le type d'un nom propre. Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Type Nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/nameType/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisUn nom propre (personne, marque, etc.).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom propre renseigné.
commonTypeStringType le plus probable du nom propre.Type du nom
commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type exemple de code pour shell:

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

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

{
    "script": "LATIN",
    "id": "a88b1bf1-56f1-40d3-84db-4daf57121b1d",
    "name": "Zippo",
    "commonType": "brand-name",
    "commonTypeAlt": "toponym",
    "score": 7.717552234146745
}

Name Type exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/nameType/Zippo")
.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": "a88b1bf1-56f1-40d3-84db-4daf57121b1d",
    "name": "Zippo",
    "commonType": "brand-name",
    "commonTypeAlt": "toponym",
    "score": 7.717552234146745
}

Name Type exemple de code pour python:

import requests

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

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": "a88b1bf1-56f1-40d3-84db-4daf57121b1d",
    "name": "Zippo",
    "commonType": "brand-name",
    "commonTypeAlt": "toponym",
    "score": 7.717552234146745
}

Name Type exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/nameType/Zippo", {
  "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": "a88b1bf1-56f1-40d3-84db-4daf57121b1d",
    "name": "Zippo",
    "commonType": "brand-name",
    "commonTypeAlt": "toponym",
    "score": 7.717552234146745
}

Type Nom (Geo)

La fonctionnalité Type Nom (Geo) analyse un nom propre, en se basant sur un contexte géographique, pour déterminer s'il s'agit du nom d'une personne (anthroponyme), d'un nom géographique (toponyme), de l'alias d'une personne (pseudonyme) ou le nom d'une marque. Nous vous recommandons de soumettre le nom complet.

  • Description : Estime le type d'un ensemble de noms propres (jusqu'à 100) en se basant sur leur contexte géographique. Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Type Nom (Geo).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeoBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
properNounsArray of objectsRequisUne liste de noms propres avec leur contexte géographique.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisUn nom propre (personne, marque, etc.).
[{...}].countryIso2StringRequisContexte géographique ou pays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
properNounsArray of objectsUne liste de noms propres avec leur type estimé.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom propre renseigné.
[{...}].commonTypeStringType le plus probable du nom propre.Type du nom
[{...}].commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"properNouns":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Edi Gathegi","countryIso2":"KE"}]}'

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Edi Gathegi",
      "countryIso2": "KE"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}

Name Type Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"properNouns\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"Edi Gathegi\",\"countryIso2\":\"KE\"}]}")
.asString();

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Edi Gathegi",
      "countryIso2": "KE"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}

Name Type Geo exemple de code pour python:

import requests

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

payload = {
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Edi Gathegi",
      "countryIso2": "KE"
    }
  ]
}
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 :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Edi Gathegi",
      "countryIso2": "KE"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}

Name Type Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Edi Gathegi",
      "countryIso2": "KE"
    }
  ]
})
});

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 :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Edi Gathegi",
      "countryIso2": "KE"
    }
  ]
}

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}
information

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

  • Description : Estime le type d'un nom propre en se basant sur son contexte géographique. Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Type Nom (Geo).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeo/{name}/{countryIso2}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisUn nom propre (personne, marque, etc.).
countryIso2StringRequisContexte géographique ou 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.
nameStringNom propre renseigné.
commonTypeStringType le plus probable du nom propre.Type du nom
commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeo/Edi%20Gathegi/KE \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "a941ea3f-3b3c-4ff1-af28-c01b086b7d79",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.5790039224226
}

Name Type Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeo/Edi%20Gathegi/KE")
.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": "a941ea3f-3b3c-4ff1-af28-c01b086b7d79",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.5790039224226
}

Name Type Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeo/Edi%20Gathegi/KE"

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": "a941ea3f-3b3c-4ff1-af28-c01b086b7d79",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.5790039224226
}

Name Type Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeo/Edi%20Gathegi/KE", {
  "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": "a941ea3f-3b3c-4ff1-af28-c01b086b7d79",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.5790039224226
}

Séparer les noms complets

Le logiciel de Namsor propose une API de séparation de noms. Nous pouvons prendre un nom complet et le diviser en une structure de prénom et de nom de famille. Notre API prend également en charge les noms chinois, en pinyin ou mandarin, et les noms japonais écrits en caractères kanji.

Diviser Nom

La fonctionnalité Diviser identifie le prénom et le nom de famille à partir d'un nom complet non divisé. La fonctionnalité Diviser Nom Geo permet d'améliorer la précision lors de la division du nom complet en ajoutant un pays de résidence.

  • Description : Identifie la structure (prénom et nom de famille) à partir d'un ensemble de noms complets (jusqu'à 100).
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets non divisés.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis divisés en structure de prénom et de nom de famille.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
[{...}].nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
[{...}].firstLastNameObjectNom complet divisé en prénom et nom de famille.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringPrénom estimé.
{...}.lastNameStringNom de famille estimé.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"John Smith"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "John Smith"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "John Smith",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "John",
                "lastName": "Smith"
            },
            "score": 23.31368511252333
        }
    ]
}

Split Name exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "John Smith"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "John Smith",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "John",
                "lastName": "Smith"
            },
            "score": 23.31368511252333
        }
    ]
}

Split Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "John Smith"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "John Smith"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "John Smith",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "John",
                "lastName": "Smith"
            },
            "score": 23.31368511252333
        }
    ]
}

Split Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "John Smith"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "John Smith"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "John Smith",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "John",
                "lastName": "Smith"
            },
            "score": 23.31368511252333
        }
    ]
}
information

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

  • Description : identifie le prénom et le nom de famille à partir d'un nom complet.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom complet renseigné.
nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
firstLastNameObjectA origined name..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringPrénom le plus vraisemblable.
{...}.lastNameStringNom de famille le plus vraisemblable.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/John%20Smith \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "3fb36d3d-f9cd-4ccc-a348-38d9e5b5232d",
    "name": "John Smith",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "John",
        "lastName": "Smith"
    },
    "score": 23.313692197779005
}

Split Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/John%20Smith")
.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": "3fb36d3d-f9cd-4ccc-a348-38d9e5b5232d",
    "name": "John Smith",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "John",
        "lastName": "Smith"
    },
    "score": 23.313692197779005
}

Split Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/John%20Smith"

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": "3fb36d3d-f9cd-4ccc-a348-38d9e5b5232d",
    "name": "John Smith",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "John",
        "lastName": "Smith"
    },
    "score": 23.313692197779005
}

Split Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/John%20Smith", {
  "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": "3fb36d3d-f9cd-4ccc-a348-38d9e5b5232d",
    "name": "John Smith",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "John",
        "lastName": "Smith"
    },
    "score": 23.313692197779005
}

Diviser Nom (Geo)

La fonctionnalité Diviser (Geo) traite un nom complet non divisé avec un pays de résidence pour identifier le prénom et le nom de famille, avec une précision améliorée par rapport à la fonctionnalité de base Diviser Nom.

  • Description : Identifie la structure (prénom et nom de famille) à partir d'un ensemble de noms complets (jusqu'à 100) en utilisant leur contexte géographique.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom (Geo).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameGeoBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets non divisés avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet (prénom et nom de famille).
[{...}].countryIso2StringRequisPays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis divisés en structure de prénom et de nom de famille.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
[{...}].nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
[{...}].firstLastNameObjectNom complet divisé en prénom et nom de famille.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringPrénom estimé.
{...}.lastNameStringNom de famille estimé.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Name Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Ricardo Darín","countryIso2":"AR"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Ricardo Darín",
      "countryIso2": "AR"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Ricardo Darín",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": "FN1LN2",
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "Ricardo",
                "lastName": "Darín"
            },
            "score": 3.447624982163207
        }
    ]
}

Split Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"Ricardo Darín\",\"countryIso2\":\"AR\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Ricardo Darín",
      "countryIso2": "AR"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Ricardo Darín",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": "FN1LN2",
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "Ricardo",
                "lastName": "Darín"
            },
            "score": 3.447624982163207
        }
    ]
}

Split Name Geo exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Ricardo Darín",
      "countryIso2": "AR"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Ricardo Darín",
      "countryIso2": "AR"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Ricardo Darín",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": "FN1LN2",
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "Ricardo",
                "lastName": "Darín"
            },
            "score": 3.447624982163207
        }
    ]
}

Split Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Ricardo Darín",
      "countryIso2": "AR"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Ricardo Darín",
      "countryIso2": "AR"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Ricardo Darín",
            "nameParserType": "FN1LN1",
            "nameParserTypeAlt": "FN1LN2",
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "Ricardo",
                "lastName": "Darín"
            },
            "score": 3.447624982163207
        }
    ]
}
information

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

  • Description : Identifie la structure (prénom et nom de famille) à partir d'un nom complet en utilisant son contexte géographique.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom (Geo).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/{name}/{countryIso2}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet (prénom et nom de famille).
countryIso2StringRequisPays 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.
nameStringNom complet renseigné.
nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
firstLastNameObjectNom complet divisé en prénom et nom de famille.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringPrénom estimé.
{...}.lastNameStringNom de famille estimé.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Name Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/Ricardo%20Darín/AR \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "dbe186ee-cfd6-48e0-a449-00c70df61ec3",
    "name": "Ricardo Darín",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": "FN1LN2",
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "Ricardo",
        "lastName": "Darín"
    },
    "score": 3.4476222927492017
}

Split Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/Ricardo%20Darín/AR")
.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": "dbe186ee-cfd6-48e0-a449-00c70df61ec3",
    "name": "Ricardo Darín",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": "FN1LN2",
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "Ricardo",
        "lastName": "Darín"
    },
    "score": 3.4476222927492017
}

Split Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/Ricardo%20Darín/AR"

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": "dbe186ee-cfd6-48e0-a449-00c70df61ec3",
    "name": "Ricardo Darín",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": "FN1LN2",
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "Ricardo",
        "lastName": "Darín"
    },
    "score": 3.4476222927492017
}

Split Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseName/Ricardo%20Darín/AR", {
  "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": "dbe186ee-cfd6-48e0-a449-00c70df61ec3",
    "name": "Ricardo Darín",
    "nameParserType": "FN1LN1",
    "nameParserTypeAlt": "FN1LN2",
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "Ricardo",
        "lastName": "Darín"
    },
    "score": 3.4476222927492017
}

Noms Japonais

Namsor fournit une API de traitement de noms spécialisée dédiée à l'analyse des noms en langue japonaise. Nous avons développé un convertisseur de noms, axé sur les noms japonais, pour vous aider à trouver les meilleures transcriptions possibles. Avec notre API, vous pouvez convertir les noms japonais dans les deux sens entre le kanji et l'anglais. Vous pouvez évaluer la qualité d'une transcription entre un nom en Kanji et un nom en caractères latins. Il est également possible de diviser les noms complets japonais, en caractères kanji ou latins, en un prénom et un nom de famille ainsi que d'estimer le genre d'un nom.

Traduire Nom Japonais en Latin

La fonctionnalité Traduire Nom Japonais en Latin convertit un prénom et/ou un nom de famille japonais écrit en caractères kanji, en alphabet latin. La conversion d'un nom japonais écrit en kanji vers l'alphabet latin s'appelle la romanisation. Plusieurs conversions pour un même nom sont possibles. C'est pourquoi la fonctionnalité renvoie une liste de noms convertis triés du plus probable au moins probable et accompagnés d'une probabilité calibrée.

  • Description : Renvoie les transcriptions latines les plus probables d'un ensemble de prénoms et/ou noms de famille japonais écrits en caractères kanji.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Japonais en Latin.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidatesBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms japonais personnels écrits en caractères kanji.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom japonais écrit en kanji.
[{...}].lastNameStringOptionelNom de famille japonais écrit en kanji.
Réponse
NomTypeDescriptionÉnumérateurs
namesAndMatchCandidatesArray of objectsListe des noms soumis convertis en alphabet latin.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].orderOptionStringOrdre de tri pour 'matchCandidates'.
[{...}].matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringInferred transcription of the submitted name to Latin alphabet.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Japanese Name To Latin exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidatesBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"塩田","lastName":"千春"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "塩田",
      "lastName": "千春"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "塩田",
            "lastName": "千春",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "chiharu shiota",
                    "probability": 0.5000000149011616,
                    "predScoreGivenName": -0.3543974459171295,
                    "predScoreFamilyName": -0.004423846025019884
                },
                {
                    "candidateName": "chiharu shioda",
                    "probability": 0.2500000074505808,
                    "predScoreGivenName": -1.2378724813461304,
                    "predScoreFamilyName": -0.004423846025019884
                }
            ]
        }
    ]
}

Translate Japanese Name To Latin exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "塩田",
      "lastName": "千春"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "塩田",
            "lastName": "千春",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "chiharu shiota",
                    "probability": 0.5000000149011616,
                    "predScoreGivenName": -0.3543974459171295,
                    "predScoreFamilyName": -0.004423846025019884
                },
                {
                    "candidateName": "chiharu shioda",
                    "probability": 0.2500000074505808,
                    "predScoreGivenName": -1.2378724813461304,
                    "predScoreFamilyName": -0.004423846025019884
                }
            ]
        }
    ]
}

Translate Japanese Name To Latin exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "塩田",
      "lastName": "千春"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "塩田",
      "lastName": "千春"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "塩田",
            "lastName": "千春",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "chiharu shiota",
                    "probability": 0.5000000149011616,
                    "predScoreGivenName": -0.3543974459171295,
                    "predScoreFamilyName": -0.004423846025019884
                },
                {
                    "candidateName": "chiharu shioda",
                    "probability": 0.2500000074505808,
                    "predScoreGivenName": -1.2378724813461304,
                    "predScoreFamilyName": -0.004423846025019884
                }
            ]
        }
    ]
}

Translate Japanese Name To Latin exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "塩田",
      "lastName": "千春"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "塩田",
            "lastName": "千春",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "chiharu shiota",
                    "probability": 0.5000000149011616,
                    "predScoreGivenName": -0.3543974459171295,
                    "predScoreFamilyName": -0.004423846025019884
                },
                {
                    "candidateName": "chiharu shioda",
                    "probability": 0.2500000074505808,
                    "predScoreGivenName": -1.2378724813461304,
                    "predScoreFamilyName": -0.004423846025019884
                }
            ]
        }
    ]
}
information

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

  • Description : Renvoie les transcriptions latines (romanisation) les plus probables d'un prénom et/ou d'un nom de famille japonais écrit en caractères kanji.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Japonais en Latin.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidates/{lastName}/{firstName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille japonais écrit en kanji.
firstNameStringRequisPrénom japonais écrit en kanji.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
orderOptionStringOrdre de tri pour 'matchCandidates'.
matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en alphabet latin du nom soumis.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Japanese Name To Latin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidates/千春/塩田 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "HAN",
    "id": null,
    "firstName": "塩田",
    "lastName": "千春",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "chiharu shiota",
            "probability": 0.5000000149011616,
            "predScoreGivenName": -0.3543974459171295,
            "predScoreFamilyName": -0.004423846025019884
        },
        {
            "candidateName": "chiharu shioda",
            "probability": 0.2500000074505808,
            "predScoreGivenName": -1.2378724813461304,
            "predScoreFamilyName": -0.004423846025019884
        }
    ]
}

Translate Japanese Name To Latin exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidates/千春/塩田")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "HAN",
    "id": null,
    "firstName": "塩田",
    "lastName": "千春",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "chiharu shiota",
            "probability": 0.5000000149011616,
            "predScoreGivenName": -0.3543974459171295,
            "predScoreFamilyName": -0.004423846025019884
        },
        {
            "candidateName": "chiharu shioda",
            "probability": 0.2500000074505808,
            "predScoreGivenName": -1.2378724813461304,
            "predScoreFamilyName": -0.004423846025019884
        }
    ]
}

Translate Japanese Name To Latin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidates/千春/塩田"

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": "HAN",
    "id": null,
    "firstName": "塩田",
    "lastName": "千春",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "chiharu shiota",
            "probability": 0.5000000149011616,
            "predScoreGivenName": -0.3543974459171295,
            "predScoreFamilyName": -0.004423846025019884
        },
        {
            "candidateName": "chiharu shioda",
            "probability": 0.2500000074505808,
            "predScoreGivenName": -1.2378724813461304,
            "predScoreFamilyName": -0.004423846025019884
        }
    ]
}

Translate Japanese Name To Latin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidates/千春/塩田", {
  "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": "HAN",
    "id": null,
    "firstName": "塩田",
    "lastName": "千春",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "chiharu shiota",
            "probability": 0.5000000149011616,
            "predScoreGivenName": -0.3543974459171295,
            "predScoreFamilyName": -0.004423846025019884
        },
        {
            "candidateName": "chiharu shioda",
            "probability": 0.2500000074505808,
            "predScoreGivenName": -1.2378724813461304,
            "predScoreFamilyName": -0.004423846025019884
        }
    ]
}

Traduire Nom Japonais en Kanji

La fonctionnalité Traduire Nom Japonais en Kanji transcrit un prénom ou un nom de famille japonais (ou les deux pour plus de précision) écrit en alphabet latin vers les caractères kanji. La conversion en alphabet latin d'un nom japonais écrit en kanji s'appelle la romanisation. Plusieurs transcriptions pour le même nom sont possibles. C'est pourquoi la fonctionnalité renvoie une liste de noms transcrits accompagnés d'une probabilité calibrée et triés du plus probable au moins probable.

information

La transcription du nom fonctionnera avec une plus grande précision pour les noms identifiés comme étant des noms japonais.

  • Description : Renvoie les transcriptions Kanji les plus probables, de jusqu'à 100 prénoms et/ou noms de famille japonais écrits en alphabet latin (romanisé).
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Japonais en Kanji.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidatesBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms japonais personnels écrits en alphabet latin.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom japonais écrit en latin.
[{...}].lastNameStringOptionelNom de famille japonais écrit en latin.
Réponse
NomTypeDescriptionÉnumérateurs
namesAndMatchCandidatesArray of objectsListe des noms soumis convertis en caractères Kanji.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].orderOptionStringOrdre de tri pour 'matchCandidates'.
[{...}].matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en kanji du nom soumis.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Japanese Name To Kanji exemple de code pour shell:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Sanae",
      "lastName": "Yamamoto"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Sanae",
            "lastName": "Yamamoto",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "山本 早苗",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -0.03954087197780609,
                    "predScoreFamilyName": -0.014371121302247047
                },
                {
                    "candidateName": "山本 沙苗",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -5.180787086486816,
                    "predScoreFamilyName": -0.014371121302247047
                }
            ]
        }
    ]
}

Translate Japanese Name To Kanji exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Sanae",
      "lastName": "Yamamoto"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Sanae",
            "lastName": "Yamamoto",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "山本 早苗",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -0.03954087197780609,
                    "predScoreFamilyName": -0.014371121302247047
                },
                {
                    "candidateName": "山本 沙苗",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -5.180787086486816,
                    "predScoreFamilyName": -0.014371121302247047
                }
            ]
        }
    ]
}

Translate Japanese Name To Kanji exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Sanae",
      "lastName": "Yamamoto"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Sanae",
      "lastName": "Yamamoto"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Sanae",
            "lastName": "Yamamoto",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "山本 早苗",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -0.03954087197780609,
                    "predScoreFamilyName": -0.014371121302247047
                },
                {
                    "candidateName": "山本 沙苗",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -5.180787086486816,
                    "predScoreFamilyName": -0.014371121302247047
                }
            ]
        }
    ]
}

Translate Japanese Name To Kanji exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Sanae",
      "lastName": "Yamamoto"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Sanae",
            "lastName": "Yamamoto",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "山本 早苗",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -0.03954087197780609,
                    "predScoreFamilyName": -0.014371121302247047
                },
                {
                    "candidateName": "山本 沙苗",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -5.180787086486816,
                    "predScoreFamilyName": -0.014371121302247047
                }
            ]
        }
    ]
}
information

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

  • Description : Renvoie les transcriptions en kanji les plus probables d'un prénom et/ou d'un nom de famille japonais écrit en alphabet latin (romanisé).
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Japonais en Kanji.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/{lastName}/{firstName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille japonais écrit en latin.
firstNameStringRequisPrénom japonais écrit en latin.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
orderOptionStringOrdre de tri pour 'matchCandidates'.
matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en kanji du nom soumis.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Japanese Name To Kanji exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.03954087197780609,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 沙苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -5.180787086486816,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Translate Japanese Name To Kanji exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae")
.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": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.03954087197780609,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 沙苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -5.180787086486816,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Translate Japanese Name To Kanji exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae"

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": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.03954087197780609,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 沙苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -5.180787086486816,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Translate Japanese Name To Kanji exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae", {
  "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": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.03954087197780609,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 沙苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -5.180787086486816,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Traduire Nom Japonais en Kanji (Genre)

La fonction Traduire Nom Japonais en Kanji (Genre) transcrit un prénom japonais ou un nom de famille japonais (ou les deux) écrit en alphabet latin, en caractères kanji. Cette fonctionnalité se base sur le genre pour améliorer la précision de la transcription par rapport à la fonctionnalité de base Traduire Nom Japonais en Kanji. La fonctionnalité renvoie une liste des noms transcrits triés du plus probable au moins probable et accompagnés d'une probabilité calibrée.

information

La transcription du nom fonctionnera avec une plus grande précision pour les noms identifiés comme étant des noms japonais.

  • Description : Renvoie les transcriptions en kanji les plus probables de jusqu'à 100 prénoms et/ou noms de famille japonais en alphabet latin, avec une précision améliorée grâce aux genres renseignés.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Japonais en Kanji (Genre).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameGenderKanjiCandidatesBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms japonais personnels écrits en alphabet latin avec un genre connu.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom japonais écrit en latin.
[{...}].lastNameStringOptionelNom de famille japonais écrit en latin.
[{...}].genderStringRequisGenre le plus probable (female ou male).
Réponse
NomTypeDescriptionÉnumérateurs
namesAndMatchCandidatesArray of objectsListe des noms soumis convertis en caractères Kanji.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].orderOptionStringOrdre de tri pour 'matchCandidates'.
[{...}].matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en kanji du nom soumis.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Japanese Name To Kanji Gender exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameGenderKanjiCandidatesBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Takashi","lastName":"Murakami","gender":"male"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Takashi",
      "lastName": "Murakami",
      "gender": "male"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Takashi",
            "lastName": "Murakami",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "村上 隆",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -2.249242067337036,
                    "predScoreFamilyName": -0.0006758159724995494
                },
                {
                    "candidateName": "村上 崇",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -2.572237014770508,
                    "predScoreFamilyName": -0.0006758159724995494
                }
            ]
        }
    ]
}

Translate Japanese Name To Kanji Gender exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Takashi",
      "lastName": "Murakami",
      "gender": "male"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Takashi",
            "lastName": "Murakami",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "村上 隆",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -2.249242067337036,
                    "predScoreFamilyName": -0.0006758159724995494
                },
                {
                    "candidateName": "村上 崇",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -2.572237014770508,
                    "predScoreFamilyName": -0.0006758159724995494
                }
            ]
        }
    ]
}

Translate Japanese Name To Kanji Gender exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Takashi",
      "lastName": "Murakami",
      "gender": "male"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Takashi",
      "lastName": "Murakami",
      "gender": "male"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Takashi",
            "lastName": "Murakami",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "村上 隆",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -2.249242067337036,
                    "predScoreFamilyName": -0.0006758159724995494
                },
                {
                    "candidateName": "村上 崇",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -2.572237014770508,
                    "predScoreFamilyName": -0.0006758159724995494
                }
            ]
        }
    ]
}

Translate Japanese Name To Kanji Gender exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Takashi",
      "lastName": "Murakami",
      "gender": "male"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Takashi",
            "lastName": "Murakami",
            "orderOption": "OrderScoreSquareFNLN",
            "matchCandidates": [
                {
                    "candidateName": "村上 隆",
                    "probability": 0.5000000000000001,
                    "predScoreGivenName": -2.249242067337036,
                    "predScoreFamilyName": -0.0006758159724995494
                },
                {
                    "candidateName": "村上 崇",
                    "probability": 0.25000000000000006,
                    "predScoreGivenName": -2.572237014770508,
                    "predScoreFamilyName": -0.0006758159724995494
                }
            ]
        }
    ]
}
information

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

  • Description : Renvoie les transcriptions en kanji les plus probables d'un prénom et/ou d'un nom de famille japonais écrit en alphabet latin (romanisé) avec une précision améliorée grâce au genre indiqué.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Japonais en Kanji (Genre).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/{lastName}/{firstName}/{gender}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille japonais écrit en latin.
firstNameStringRequisPrénom japonais écrit en latin.
genderStringRequisGenre le plus probable (female ou male).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
orderOptionStringOrdre de tri pour 'matchCandidates'.
matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en kanji du nom soumis.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Japanese Name To Kanji Gender exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae/male \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.031474947929382324,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 佐苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -4.911670207977295,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Translate Japanese Name To Kanji Gender exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae/male")
.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": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.031474947929382324,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 佐苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -4.911670207977295,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Translate Japanese Name To Kanji Gender exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae/male"

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": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.031474947929382324,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 佐苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -4.911670207977295,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Translate Japanese Name To Kanji Gender exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidates/Yamamoto/Sanae/male", {
  "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": null,
    "firstName": "Sanae",
    "lastName": "Yamamoto",
    "orderOption": "OrderScoreSquareFNLN",
    "matchCandidates": [
        {
            "candidateName": "山本 早苗",
            "probability": 0.5000000000000001,
            "predScoreGivenName": -0.031474947929382324,
            "predScoreFamilyName": -0.014371121302247047
        },
        {
            "candidateName": "山本 佐苗",
            "probability": 0.25000000000000006,
            "predScoreGivenName": -4.911670207977295,
            "predScoreFamilyName": -0.014371121302247047
        }
    ]
}

Évalue Nom Japonais

La fonctionnalité Évalue Nom Japonais évalue et note la qualité d'une transcription entre un nom japonais écrit en caractères latins et un nom japonais écrit en kanji. La fonctionnalité renvoie l'état de la transcription et note la qualité de la transcription.

  • Description : Évalue la qualité d'un ensemble de transcriptions (jusqu'à 100) entre un nom japonais écrit en latin et un nom japonais écrit en Kanji.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Évalue Nom Japonais.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatchBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms japonais personnels en caractères kanji et en alphabet latin.
[{...}].idStringOptionelIdentifiant unique.
[{...}].name1ObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequisPrénom japonais écrit en alphabet latin.
{...}.lastNameStringRequisNom de famille japonais écrit en alphabet latin.
[{...}].name2ObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.nameStringRequisNom complet japonais (prénom et nom de famille) écrit en kanji.
Réponse
NomTypeDescriptionÉnumérateurs
matchedNamesArray of objectsListe des noms japonais soumis avec l'état de leur transcription.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].matchStatusStringStatut de réussite de la transcription.Statut de transcriptions
[{...}].scoreNumberPlus élevé implique une meilleure transcription, le score n'est pas normalisé.

Exemples d'intégration:

Match Japanese Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatchBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c41","name1":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Tessai","lastName":"Tomioka"},"name2":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c43","name":"富岡 鉄斎"}}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Tessai",
        "lastName": "Tomioka"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "富岡 鉄斎"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.002224089213585
        }
    ]
}

Match Japanese Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatchBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c41\",\"name1\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Tessai\",\"lastName\":\"Tomioka\"},\"name2\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c43\",\"name\":\"富岡 鉄斎\"}}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Tessai",
        "lastName": "Tomioka"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "富岡 鉄斎"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.002224089213585
        }
    ]
}

Match Japanese Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Tessai",
        "lastName": "Tomioka"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "富岡 鉄斎"
      }
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Tessai",
        "lastName": "Tomioka"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "富岡 鉄斎"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.002224089213585
        }
    ]
}

Match Japanese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatchBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Tessai",
        "lastName": "Tomioka"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "富岡 鉄斎"
      }
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Tessai",
        "lastName": "Tomioka"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "富岡 鉄斎"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.002224089213585
        }
    ]
}
information

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

  • Description : Évalue la qualité d'une transcription entre un nom japonais écrit en latin et un nom japonais écrit en Kanji.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Évalue Nom Japonais.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatch/{lastName}/{firstName}/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille japonais écrit en alphabet latin.
firstNameStringRequisPrénom japonais écrit en alphabet latin.
nameStringRequisNom complet japonais (prénom et nom de famille) écrit en Kanji.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
matchStatusStringStatut de réussite de la transcription.Statut de transcriptions
scoreNumberPlus élevé implique une meilleure transcription, le score n'est pas normalisé.

Exemples d'intégration:

Match Japanese Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatch/Tomioka/Tessai/富岡%20鉄斎 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.002224089213585
}

Match Japanese Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatch/Tomioka/Tessai/富岡%20鉄斎")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.002224089213585
}

Match Japanese Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatch/Tomioka/Tessai/富岡%20鉄斎"

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": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.002224089213585
}

Match Japanese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatch/Tomioka/Tessai/富岡%20鉄斎", {
  "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": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.002224089213585
}

Genre Nom Japonais

La fonctionnalité Genre Nom japonais identifie avec précision le genre à partir d'un prénom et d'un nom de famille japonais (optionel), écrit en kanji ou en alphabet latin, avec une précision légèrement améliorée par rapport à la fonctionnalité Genre Nom Complet Japonais. La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité du genre identifié est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom non-genré.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 prénoms et noms de famille (optionel) japonais écrits en alphabet latin ou en caractères kanji.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Japonais.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms japonais.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringRequisPrénom japonais écrit en caractères latins ou kanji.
[{...}].lastNameStringOptionelNom de famille japonais écrit en caractères latins ou kanji.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms japonais soumis genré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é.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Japanese Name exemple de code pour shell:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Satoshi",
      "lastName": "Nakamoto"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Satoshi",
            "lastName": "Nakamoto",
            "likelyGender": "male",
            "genderScale": -0.9828731991489774,
            "score": 24.94061932678776,
            "probabilityCalibrated": 0.9914365995744887
        }
    ]
}

Genderize Japanese Name exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Satoshi",
      "lastName": "Nakamoto"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Satoshi",
            "lastName": "Nakamoto",
            "likelyGender": "male",
            "genderScale": -0.9828731991489774,
            "score": 24.94061932678776,
            "probabilityCalibrated": 0.9914365995744887
        }
    ]
}

Genderize Japanese Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Satoshi",
      "lastName": "Nakamoto"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Satoshi",
      "lastName": "Nakamoto"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Satoshi",
            "lastName": "Nakamoto",
            "likelyGender": "male",
            "genderScale": -0.9828731991489774,
            "score": 24.94061932678776,
            "probabilityCalibrated": 0.9914365995744887
        }
    ]
}

Genderize Japanese Name exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Satoshi",
      "lastName": "Nakamoto"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Satoshi",
            "lastName": "Nakamoto",
            "likelyGender": "male",
            "genderScale": -0.9828731991489774,
            "score": 24.94061932678776,
            "probabilityCalibrated": 0.9914365995744887
        }
    ]
}
information

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

  • Description : Renvoie le genre le plus probable d'un prénom et d'un nom de famille japonais écrits en alphabet latin ou en caractères kanji.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Japonais.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseName/{lastName}/{firstName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille japonais écrit en caractères latins ou kanji.
firstNameStringRequisPrénom japonais écrit en caractères latins ou kanji.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Japanese Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseName/Nakamoto/Satoshi \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "9cfd8321-0924-4570-a4b7-29a611ce5089",
    "firstName": "Satoshi",
    "lastName": "Nakamoto",
    "likelyGender": "male",
    "genderScale": -0.9828731991489774,
    "score": 24.94061932678776,
    "probabilityCalibrated": 0.9914365995744887
}

Genderize Japanese Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseName/Nakamoto/Satoshi")
.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": "9cfd8321-0924-4570-a4b7-29a611ce5089",
    "firstName": "Satoshi",
    "lastName": "Nakamoto",
    "likelyGender": "male",
    "genderScale": -0.9828731991489774,
    "score": 24.94061932678776,
    "probabilityCalibrated": 0.9914365995744887
}

Genderize Japanese Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseName/Nakamoto/Satoshi"

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": "9cfd8321-0924-4570-a4b7-29a611ce5089",
    "firstName": "Satoshi",
    "lastName": "Nakamoto",
    "likelyGender": "male",
    "genderScale": -0.9828731991489774,
    "score": 24.94061932678776,
    "probabilityCalibrated": 0.9914365995744887
}

Genderize Japanese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseName/Nakamoto/Satoshi", {
  "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": "9cfd8321-0924-4570-a4b7-29a611ce5089",
    "firstName": "Satoshi",
    "lastName": "Nakamoto",
    "likelyGender": "male",
    "genderScale": -0.9828731991489774,
    "score": 24.94061932678776,
    "probabilityCalibrated": 0.9914365995744887
}

Genre Nom Complet Japonais

La fonctionnalité Genre Nom Complet Japonais identifie avec précision le genre à partir d'un nom complet japonais (prénom et nom de famille) écrit en caractères kanji. La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité du genre renvoyé est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom unisexe.

information

Si le prénom et le nom sont clairement identifiables, la fonction Genre Nom Japonais sera légèrement plus précise.

  • Description : Identifie le genre le plus probable d'un maximum de 100 noms complets japonais non divisés (noms de famille et prénoms), écrits en caractères kanji ou en alphabet latin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet Japonais.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFullBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets japonais.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet japonais (prénom et nom de famille) écrit en kanji ou en latin.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets japonais soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Japanese Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"中松 義郎"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "中松 義郎"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "中松 義郎",
            "likelyGender": "male",
            "genderScale": -0.22231473979961303,
            "score": 3.72410721464353,
            "probabilityCalibrated": 0.6111573698998065
        }
    ]
}

Genderize Japanese Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"中松 義郎\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "中松 義郎"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "中松 義郎",
            "likelyGender": "male",
            "genderScale": -0.22231473979961303,
            "score": 3.72410721464353,
            "probabilityCalibrated": 0.6111573698998065
        }
    ]
}

Genderize Japanese Full Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "中松 義郎"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "中松 義郎"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "中松 義郎",
            "likelyGender": "male",
            "genderScale": -0.22231473979961303,
            "score": 3.72410721464353,
            "probabilityCalibrated": 0.6111573698998065
        }
    ]
}

Genderize Japanese Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "中松 義郎"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "中松 義郎"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "中松 義郎",
            "likelyGender": "male",
            "genderScale": -0.22231473979961303,
            "score": 3.72410721464353,
            "probabilityCalibrated": 0.6111573698998065
        }
    ]
}
information

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

  • Description : Renvoie le genre le plus probable d'un nom complet japonais (prénom et nom de famille), écrit en caractères kanji ou en alphabet latin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet Japonais.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFull/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet japonais (prénom et nom de famille) écrit en kanji ou en latin.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Japanese Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFull/中松%20義郎 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "HAN",
    "id": "36990426-d289-43b3-99dc-50ccfe2e5ade",
    "name": "中松 義郎",
    "likelyGender": "male",
    "genderScale": -0.22231473979961303,
    "score": 3.72410721464353,
    "probabilityCalibrated": 0.6111573698998065
}

Genderize Japanese Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFull/中松%20義郎")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "HAN",
    "id": "36990426-d289-43b3-99dc-50ccfe2e5ade",
    "name": "中松 義郎",
    "likelyGender": "male",
    "genderScale": -0.22231473979961303,
    "score": 3.72410721464353,
    "probabilityCalibrated": 0.6111573698998065
}

Genderize Japanese Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFull/中松%20義郎"

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": "HAN",
    "id": "36990426-d289-43b3-99dc-50ccfe2e5ade",
    "name": "中松 義郎",
    "likelyGender": "male",
    "genderScale": -0.22231473979961303,
    "score": 3.72410721464353,
    "probabilityCalibrated": 0.6111573698998065
}

Genderize Japanese Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFull/中松%20義郎", {
  "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": "HAN",
    "id": "36990426-d289-43b3-99dc-50ccfe2e5ade",
    "name": "中松 義郎",
    "likelyGender": "male",
    "genderScale": -0.22231473979961303,
    "score": 3.72410721464353,
    "probabilityCalibrated": 0.6111573698998065
}

Diviser Nom Japonais

La fonctionnalité Diviser Nom Japonais identifie avec précision le prénom et le nom de famille à partir d'un nom complet japonais non divisé écrit en alphabet latin ou en caractères kanji.

  • Description : Identifie les prénoms et noms de famille à partir d'un groupe de noms complets écrits en alphabet kanji ou latin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom Japonais.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseNameBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets japonais non divisés.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet japonais (prénom et nom de famille) en alphabet kanji ou latin.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms japonais soumis divisés en structure de prénom et de nom de famille.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
[{...}].nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
[{...}].firstLastNameObjectA list of parsed names..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringPrénom le plus probable.
{...}.lastNameStringNom de famille le plus probable.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Japanese Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseNameBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"小島 秀夫"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "小島 秀夫"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "小島 秀夫",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "秀夫",
                "lastName": "小島"
            },
            "score": 100
        }
    ]
}

Split Japanese Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseNameBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"小島 秀夫\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "小島 秀夫"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "小島 秀夫",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "秀夫",
                "lastName": "小島"
            },
            "score": 100
        }
    ]
}

Split Japanese Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "小島 秀夫"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "小島 秀夫"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "小島 秀夫",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "秀夫",
                "lastName": "小島"
            },
            "score": 100
        }
    ]
}

Split Japanese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseNameBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "小島 秀夫"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "小島 秀夫"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "小島 秀夫",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "秀夫",
                "lastName": "小島"
            },
            "score": 100
        }
    ]
}
information

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

  • Description : Identifie la structure (prénom et nom de famille) à partir d'un nom complet japonais écrit en kanji ou en latin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom Japonais.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseName/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet japonais (prénom et nom de famille) en alphabet kanji ou latin.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom complet renseigné.
nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
firstLastNameObjectA origined name..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringPrénom le plus probable.
{...}.lastNameStringNom de famille le plus probable.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Japanese Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseName/小島%20秀夫 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "HAN",
    "id": "4646501e-33e3-44bc-be6f-66cab4bb5e94",
    "name": "小島 秀夫",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "秀夫",
        "lastName": "小島"
    },
    "score": 100
}

Split Japanese Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseName/小島%20秀夫")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "HAN",
    "id": "4646501e-33e3-44bc-be6f-66cab4bb5e94",
    "name": "小島 秀夫",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "秀夫",
        "lastName": "小島"
    },
    "score": 100
}

Split Japanese Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseName/小島%20秀夫"

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": "HAN",
    "id": "4646501e-33e3-44bc-be6f-66cab4bb5e94",
    "name": "小島 秀夫",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "秀夫",
        "lastName": "小島"
    },
    "score": 100
}

Split Japanese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseName/小島%20秀夫", {
  "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": "HAN",
    "id": "4646501e-33e3-44bc-be6f-66cab4bb5e94",
    "name": "小島 秀夫",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "秀夫",
        "lastName": "小島"
    },
    "score": 100
}

Noms Chinois

Namsor fournit une API d'analyse de nom dédiée pour le traitement des noms chinois. Notre IA de reconnaissance de noms peut traduire des noms chinois en anglais (pinyin). Vous pouvez : déduire le genre d'un nom chinois ou diviser un nom complet chinois en un prénom et un nom de famille. Nous sommes également en mesure d'évaluer la qualité d'une transcription entre un nom en pinyin et un nom en chinois mandarin standard.

Traduire Nom Chinois en Pinyin

La fonction Traduire Nom Chinois en Pinyin transcrit un nom complet chinois écrit en chinois Mandarin standard vers le pinyin (alphabet latin). Le pinyin est utilisé pour représenter les logogrammes en Mandarin avec l'alphabet latin. Il est utilisé par des langues telles que le français.

information

La transcription en Pinyin du nom ne fonctionnera qu'avec un nom complet chinois (prénom et nom de famille).

  • Description : Renvoie la transcription en pinyin la plus probable d'un ensemble de noms complets chinois (jusqu'à 100) écrits en chinois Mandarin standard.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Chinois en Pinyin.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseNameBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets chinois (prénom et nom de famille) en chinois Mandarin standard.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis convertis en Pinyin (alphabet latin).
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
[{...}].nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
[{...}].firstLastNameObjectA list of Pinyin names..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringTranscription la plus probable du prénom en pinyin.
{...}.lastNameStringTranscription la plus probable du nom de famille en pinyin.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Translate Chinese Name To Pinyin exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseNameBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"赵丽颖"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "LiYing",
                "lastName": "Zhao"
            },
            "score": 4.641021485371256
        }
    ]
}

Translate Chinese Name To Pinyin exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseNameBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"赵丽颖\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "LiYing",
                "lastName": "Zhao"
            },
            "score": 4.641021485371256
        }
    ]
}

Translate Chinese Name To Pinyin exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "LiYing",
                "lastName": "Zhao"
            },
            "score": 4.641021485371256
        }
    ]
}

Translate Chinese Name To Pinyin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseNameBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "LiYing",
                "lastName": "Zhao"
            },
            "score": 4.641021485371256
        }
    ]
}
information

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

  • Description : Renvoie la transcription en pinyin la plus probable d'un nom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Chinois en Pinyin.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseName/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom complet renseigné.
nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
firstLastNameObjectA pinyin name..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringTranscription la plus probable du prénom en pinyin.
{...}.lastNameStringTranscription la plus probable du nom de famille en pinyin.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Translate Chinese Name To Pinyin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseName/赵丽颖 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "LiYing",
        "lastName": "Zhao"
    },
    "score": 4.641021485371256
}

Translate Chinese Name To Pinyin exemple de code pour java:

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

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

{
    "script": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "LiYing",
        "lastName": "Zhao"
    },
    "score": 4.641021485371256
}

Translate Chinese Name To Pinyin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseName/赵丽颖"

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": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "LiYing",
        "lastName": "Zhao"
    },
    "score": 4.641021485371256
}

Translate Chinese Name To Pinyin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseName/赵丽颖", {
  "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": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "LiYing",
        "lastName": "Zhao"
    },
    "score": 4.641021485371256
}

Traduire Nom Chinois en Mandarin

La fonction Traduire Nom Chinois en Mandarin transcrit un prénom chinois ou un nom de famille chinois ou les deux (pour plus de précision) écrit en pinyin (alphabet latin) vers le chinois Mandarin standard. Le pinyin est utilisé pour représenter les logogrammes en Mandarin avec l'alphabet latin. Il est utilisé par des langues telles que le français et l'anglais. Plusieurs transcriptions pour le même nom sont possibles. C'est pourquoi la fonctionnalité renvoie une liste de noms transcrits, accompagnés d'une probabilité calibrée. Les transcriptions seront listées du plus probable au moins probable.

information

La transcription du nom en Mandarin ne fonctionnera qu'avec les prénoms et les noms de famille identifiés comme des noms chinois.

  • Description : Renvoie les transcriptions en chinois mandarin standard les plus probables à partir d'un ensemble de prénoms et de noms de famille écrits en pinyin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Chinois en Mandarin.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidatesBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms chinois écrits en pinyin (alphabet latin).
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom chinois écrit en pinyin.
[{...}].lastNameStringOptionelNom de famille chinois écrit en pinyin.
Réponse
NomTypeDescriptionÉnumérateurs
namesAndMatchCandidatesArray of objectsListe des noms soumis convertis en Mandarin standard.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].orderOptionStringOrdre de tri pour 'matchCandidates'.
[{...}].matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en chinois mandarin standard du nom indiqué.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Chinese Name To Mandarin exemple de code pour shell:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": null,
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.26153460755147884,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.11856235542333707,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}

Translate Chinese Name To Mandarin exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": null,
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.26153460755147884,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.11856235542333707,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}

Translate Chinese Name To Mandarin exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": null,
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.26153460755147884,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.11856235542333707,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}

Translate Chinese Name To Mandarin exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": null,
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.26153460755147884,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.11856235542333707,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}
information

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

  • Description : Renvoie les transcriptions en chinois mandarin standard les plus probables à partir d'un prénom et d'un nom de famille écrits en pinyin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Chinois en Mandarin.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidates/{lastName}/{firstName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille chinois écrit en pinyin.
firstNameStringRequisPrénom chinois écrit en pinyin.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
orderOptionStringOrdre de tri pour 'matchCandidates'.
matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en chinois mandarin standard du nom indiqué.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Chinese Name To Mandarin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidates/Zhao/LiYing \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": null,
    "id": null,
    "firstName": "LiYing",
    "lastName": "Zhao",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "赵丽英",
            "probability": 0.26153460755147884,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "赵丽颖",
            "probability": 0.11856235542333707,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Translate Chinese Name To Mandarin exemple de code pour java:

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

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

{
    "script": null,
    "id": null,
    "firstName": "LiYing",
    "lastName": "Zhao",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "赵丽英",
            "probability": 0.26153460755147884,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "赵丽颖",
            "probability": 0.11856235542333707,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Translate Chinese Name To Mandarin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidates/Zhao/LiYing"

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": null,
    "id": null,
    "firstName": "LiYing",
    "lastName": "Zhao",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "赵丽英",
            "probability": 0.26153460755147884,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "赵丽颖",
            "probability": 0.11856235542333707,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Translate Chinese Name To Mandarin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidates/Zhao/LiYing", {
  "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": null,
    "id": null,
    "firstName": "LiYing",
    "lastName": "Zhao",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "赵丽英",
            "probability": 0.26153460755147884,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "赵丽颖",
            "probability": 0.11856235542333707,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Traduire Nom Chinois en Mandarin (Genre)

La fonctionnalité Traduire Nom Chinois en Mandarin (Genre) transcrit un prénom chinois ou un nom de famille chinois ou les deux, écrits en pinyin (alphabet latin) vers le chinois mandarin standard. Cette fonctionnalité utilise le genre pour améliorer la précision de la transcription par rapport à la fonctionnalité de base Traduire Nom Chinois en Mandarin. La fonctionnalité renvoie une liste des noms transcrits les plus probables accompagnés d'une probabilité calibrée et triés du plus probable au moins probable.

information

La transcription du nom en mandarin ne fonctionnera qu'avec les prénoms et les noms de famille identifiés comme étants des noms chinois.

  • Description : Renvoie les transcriptions en chinois mandarin standard les plus probables d'un ensemble de prénoms, de nom sde famille écrits en pinyin et de leur genre afin d'améliorer la qualité des transcriptions.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Chinois en Mandarin (Genre).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidatesGenderBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms chinois écrits en pinyin (alphabet latin) avec leur genre.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom chinois écrit en pinyin.
[{...}].lastNameStringOptionelNom de famille chinois écrit en pinyin.
[{...}].genderStringRequis.
Réponse
NomTypeDescriptionÉnumérateurs
namesAndMatchCandidatesArray of objectsListe des noms soumis convertis en Mandarin standard.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].orderOptionStringOrdre de tri pour 'matchCandidates'.
[{...}].matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en chinois mandarin standard du nom indiqué.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Chinese Name To Mandarin Gender exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidatesGenderBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"LiYing","lastName":"Zhao","gender":"female"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao",
      "gender": "female"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.07949583832056487,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.021402725701690543,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}

Translate Chinese Name To Mandarin Gender exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao",
      "gender": "female"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.07949583832056487,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.021402725701690543,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}

Translate Chinese Name To Mandarin Gender exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao",
      "gender": "female"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao",
      "gender": "female"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.07949583832056487,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.021402725701690543,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}

Translate Chinese Name To Mandarin Gender exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "LiYing",
      "lastName": "Zhao",
      "gender": "female"
    }
  ]
}

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

{
    "namesAndMatchCandidates": [
        {
            "script": null,
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "LiYing",
            "lastName": "Zhao",
            "orderOption": null,
            "matchCandidates": [
                {
                    "candidateName": "赵丽英",
                    "probability": 0.07949583832056487,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                },
                {
                    "candidateName": "赵丽颖",
                    "probability": 0.021402725701690543,
                    "predScoreGivenName": 0,
                    "predScoreFamilyName": 0
                }
            ]
        }
    ]
}
information

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

  • Description : Renvoie les transcriptions en chinois mandarin standard les plus probables à partir d'un prénom, d'un nom de famille écrits en pinyin et d'un genre afin d'améliorer la qualité de la transcription.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Traduire Nom Chinois en Mandarin (Genre).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameGenderCandidates/{lastName}/{firstName}/{gender}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille chinois écrit en pinyin.
firstNameStringRequisPrénom chinois écrit en pinyin.
genderStringRequisGenre connu (female ou male).
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é.
orderOptionStringOrdre de tri pour 'matchCandidates'.
matchCandidatesArray of objectsListe des transcriptions possibles pour le nom indiqué.
[{...}].candidateNameStringTranscription en chinois mandarin standard du nom indiqué.
[{...}].probabilityNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].predScoreGivenNameNumberPlus élevé implique un résultat plus fiable (pour le prénom).
[{...}].predScoreFamilyNameNumberPlus élevé implique un résultat plus fiable (pour le nom de famille).

Exemples d'intégration:

Translate Chinese Name To Mandarin Gender exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameGenderCandidates/Fanzhi/Zeng/male \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": null,
    "id": null,
    "firstName": "Zeng",
    "lastName": "Fanzhi",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "甑范志",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "甑凡智",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Translate Chinese Name To Mandarin Gender exemple de code pour java:

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

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

{
    "script": null,
    "id": null,
    "firstName": "Zeng",
    "lastName": "Fanzhi",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "甑范志",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "甑凡智",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Translate Chinese Name To Mandarin Gender exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameGenderCandidates/Fanzhi/Zeng/male"

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": null,
    "id": null,
    "firstName": "Zeng",
    "lastName": "Fanzhi",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "甑范志",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "甑凡智",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Translate Chinese Name To Mandarin Gender exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameGenderCandidates/Fanzhi/Zeng/male", {
  "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": null,
    "id": null,
    "firstName": "Zeng",
    "lastName": "Fanzhi",
    "orderOption": null,
    "matchCandidates": [
        {
            "candidateName": "甑范志",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        },
        {
            "candidateName": "甑凡智",
            "probability": 0.014705882352941176,
            "predScoreGivenName": 0,
            "predScoreFamilyName": 0
        }
    ]
}

Évalue Nom Chinois

La fonctionnalité Évalue Nom Chinois évalue et note la qualité d'une transcription entre un nom chinois en caractères latins (pinyin) et un nom chinois écrit en Mandarin standard. La fonctionnalité renvoie l'état de la transcription et note la qualité de la transcription.

  • Description : Évalue la qualité d'une transcription entre un ensemble de noms chinois écrits en Mandarin standard et de noms chinois écrits en pinyin.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Évalue Nom Chinois.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatchBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms chinois écrits en pinyin et en chinois Mandarin standard.
[{...}].idStringOptionelIdentifiant unique.
[{...}].name1ObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequisNom de famille chinois écrit en pinyin.
{...}.lastNameStringRequisPrénom chinois écrit en pinyin.
[{...}].name2ObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.nameStringRequisNom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard.
Réponse
NomTypeDescriptionÉnumérateurs
matchedNamesArray of objectsListe des noms chinois soumis avec l'état de leur transcription.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].matchStatusStringStatut de réussite de la transcription.Statut de transcriptions
[{...}].scoreNumberPlus élevé implique une meilleure transcription, le score n'est pas normalisé.

Exemples d'intégration:

Match Chinese Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatchBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c41","name1":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Hong","lastName":"Yu"},"name2":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c43","name":"喻红"}}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Hong",
        "lastName": "Yu"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "喻红"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.0017825620273417
        }
    ]
}

Match Chinese Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatchBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c41\",\"name1\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Hong\",\"lastName\":\"Yu\"},\"name2\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c43\",\"name\":\"喻红\"}}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Hong",
        "lastName": "Yu"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "喻红"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.0017825620273417
        }
    ]
}

Match Chinese Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Hong",
        "lastName": "Yu"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "喻红"
      }
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Hong",
        "lastName": "Yu"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "喻红"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.0017825620273417
        }
    ]
}

Match Chinese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatchBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Hong",
        "lastName": "Yu"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "喻红"
      }
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
      "name1": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Hong",
        "lastName": "Yu"
      },
      "name2": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
        "name": "喻红"
      }
    }
  ]
}

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

{
    "matchedNames": [
        {
            "script": null,
            "id": null,
            "matchStatus": "Match",
            "score": 1.0017825620273417
        }
    ]
}
information

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

  • Description : Évalue la qualité d'une transcription entre un nom chinois écrit en Mandarin standard et un nom chinois écrit en pinyin.
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Évalue Nom Chinois.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatch/{lastName}/{firstName}/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille chinois écrit en pinyin.
firstNameStringRequisPrénom chinois écrit en pinyin.
nameStringRequisNom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
matchStatusStringStatut de réussite de la transcription.Statut de transcriptions
scoreNumberPlus élevé implique une meilleure transcription, le score n'est pas normalisé.

Exemples d'intégration:

Match Chinese Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatch/Yu/Hong/喻红 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.0017825620273417
}

Match Chinese Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatch/Yu/Hong/喻红")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.0017825620273417
}

Match Chinese Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatch/Yu/Hong/喻红"

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": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.0017825620273417
}

Match Chinese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatch/Yu/Hong/喻红", {
  "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": null,
    "id": null,
    "matchStatus": "Match",
    "score": 1.0017825620273417
}

Genre Nom Chinois

La fonctionnalité Genre Nom Chinois identifie avec précision le genre d'un prénom chinois et d'un nom de famille chinois (facultatif), écrits en alphabet latin (pinyin) ou en chinois Mandarin standard, avec une précision légèrement supérieure à celle de la fonctionnalité Genre Nom Complet Chinois. La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité du genre estimé est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom non-genré.

  • Description : Estime le genre le plus probable d'un ensemble de prénoms chinois et de noms de famille écrits en pinyin ou en chinois Mandarin standard.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Chinois.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyinBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms chinois.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringRequisPrénom chinois écrit en pinyin ou en chinois Mandarin.
[{...}].lastNameStringOptionelNom de famille chinois écrit en pinyin ou en chinois Mandarin.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms chinois enrichis de leur genre le plus probable.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Chinese Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyinBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Dèng","lastName":"Qīngyún"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Dèng",
      "lastName": "Qīngyún"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Dèng",
            "lastName": "Qīngyún",
            "likelyGender": "male",
            "genderScale": -0.3132515162951226,
            "score": 6.747266465582973,
            "probabilityCalibrated": 0.6566257581475613
        }
    ]
}

Genderize Chinese Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyinBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Dèng\",\"lastName\":\"Qīngyún\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Dèng",
      "lastName": "Qīngyún"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Dèng",
            "lastName": "Qīngyún",
            "likelyGender": "male",
            "genderScale": -0.3132515162951226,
            "score": 6.747266465582973,
            "probabilityCalibrated": 0.6566257581475613
        }
    ]
}

Genderize Chinese Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Dèng",
      "lastName": "Qīngyún"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Dèng",
      "lastName": "Qīngyún"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Dèng",
            "lastName": "Qīngyún",
            "likelyGender": "male",
            "genderScale": -0.3132515162951226,
            "score": 6.747266465582973,
            "probabilityCalibrated": 0.6566257581475613
        }
    ]
}

Genderize Chinese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyinBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Dèng",
      "lastName": "Qīngyún"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Dèng",
      "lastName": "Qīngyún"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Dèng",
            "lastName": "Qīngyún",
            "likelyGender": "male",
            "genderScale": -0.3132515162951226,
            "score": 6.747266465582973,
            "probabilityCalibrated": 0.6566257581475613
        }
    ]
}
information

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

  • Description : Estime le genre le plus probable d'un prénom chinois et d'un nom de famille écrits en pinyin ou en chinois Mandarin standard.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Chinois.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyin/{lastName}/{firstName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
lastNameStringRequisNom de famille chinois écrit en pinyin ou en chinois Mandarin.
firstNameStringRequisPrénom chinois écrit en pinyin ou en chinois Mandarin.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Chinese Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyin/Qīngyún/Dè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": "9c1fda7c-54f1-48d1-b082-80cc6148aeb9",
    "firstName": "Dèng",
    "lastName": "Qīngyún",
    "likelyGender": "male",
    "genderScale": -0.014201270075495653,
    "score": 1.8597729950048343,
    "probabilityCalibrated": 0.5071006350377478
}

Genderize Chinese Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyin/Qīngyún/Dè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": "9c1fda7c-54f1-48d1-b082-80cc6148aeb9",
    "firstName": "Dèng",
    "lastName": "Qīngyún",
    "likelyGender": "male",
    "genderScale": -0.014201270075495653,
    "score": 1.8597729950048343,
    "probabilityCalibrated": 0.5071006350377478
}

Genderize Chinese Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyin/Qīngyún/Dè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": "9c1fda7c-54f1-48d1-b082-80cc6148aeb9",
    "firstName": "Dèng",
    "lastName": "Qīngyún",
    "likelyGender": "male",
    "genderScale": -0.014201270075495653,
    "score": 1.8597729950048343,
    "probabilityCalibrated": 0.5071006350377478
}

Genderize Chinese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyin/Qīngyún/Dè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": "9c1fda7c-54f1-48d1-b082-80cc6148aeb9",
    "firstName": "Dèng",
    "lastName": "Qīngyún",
    "likelyGender": "male",
    "genderScale": -0.014201270075495653,
    "score": 1.8597729950048343,
    "probabilityCalibrated": 0.5071006350377478
}

Genre Nom Complet Chinois

La fonctionnalité Genre Nom Complet Chinois identifie avec précision le genre d'un nom complet chinois non divisé écrit en chinois Mandarin standard. La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité du genre renvoyé est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom unisexe.

information

La fonctionnalité Genre Nom Complet Chinois ne fonctionnera qu'avec les noms complets chinois écrits en chinois Mandarin standard.

  • Description : Détermine le genre le plus probable d'un ensemble de noms complets chinois non divisés écrits en Mandarin standard.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet Chinois.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNameBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets chinois écrits en Mandarin standard.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet chinois non divisé (prénom et nom de famille) écrit en Mandarin standard.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms chinois enrichis de leur genre le plus probable.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Chinese Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNameBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"谢晓亮"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "谢晓亮"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "谢晓亮",
            "likelyGender": "male",
            "genderScale": -0.7130895869378251,
            "score": 8.286118331853034,
            "probabilityCalibrated": 0.8565447934689125
        }
    ]
}

Genderize Chinese Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNameBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"谢晓亮\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "谢晓亮"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "谢晓亮",
            "likelyGender": "male",
            "genderScale": -0.7130895869378251,
            "score": 8.286118331853034,
            "probabilityCalibrated": 0.8565447934689125
        }
    ]
}

Genderize Chinese Full Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "谢晓亮"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "谢晓亮"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "谢晓亮",
            "likelyGender": "male",
            "genderScale": -0.7130895869378251,
            "score": 8.286118331853034,
            "probabilityCalibrated": 0.8565447934689125
        }
    ]
}

Genderize Chinese Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNameBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "谢晓亮"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "谢晓亮"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "谢晓亮",
            "likelyGender": "male",
            "genderScale": -0.7130895869378251,
            "score": 8.286118331853034,
            "probabilityCalibrated": 0.8565447934689125
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseName/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet chinois non divisé (prénom et nom de famille) écrit en Mandarin standard.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Chinese Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseName/谢晓亮 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "HAN",
    "id": "46661b4d-32cf-4ca5-b598-f62a8d7e0667",
    "name": "谢晓亮",
    "likelyGender": "male",
    "genderScale": -0.7130895869378251,
    "score": 8.286118331853034,
    "probabilityCalibrated": 0.8565447934689125
}

Genderize Chinese Full Name exemple de code pour java:

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

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

{
    "script": "HAN",
    "id": "46661b4d-32cf-4ca5-b598-f62a8d7e0667",
    "name": "谢晓亮",
    "likelyGender": "male",
    "genderScale": -0.7130895869378251,
    "score": 8.286118331853034,
    "probabilityCalibrated": 0.8565447934689125
}

Genderize Chinese Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseName/谢晓亮"

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": "HAN",
    "id": "46661b4d-32cf-4ca5-b598-f62a8d7e0667",
    "name": "谢晓亮",
    "likelyGender": "male",
    "genderScale": -0.7130895869378251,
    "score": 8.286118331853034,
    "probabilityCalibrated": 0.8565447934689125
}

Genderize Chinese Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseName/谢晓亮", {
  "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": "HAN",
    "id": "46661b4d-32cf-4ca5-b598-f62a8d7e0667",
    "name": "谢晓亮",
    "likelyGender": "male",
    "genderScale": -0.7130895869378251,
    "score": 8.286118331853034,
    "probabilityCalibrated": 0.8565447934689125
}

Diviser Nom Chinois

La fonction Diviser Nom Chinois identifie avec précision le prénom et le nom de famille à partir d'un nom complet chinois non divisé écrit en alphabet latin (pinyin) ou en chinois Mandarin standard.

  • Description : Identifie la structure (prénom et nom de famille) d'un ensemble de noms complets chinois écrits en Mandarin standard ou en pinyin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom Chinois.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseNameBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets chinois non divisés.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard ou en pinyin.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms chinois soumis divisés en structure de prénom et de nom de famille.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
[{...}].nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
[{...}].firstLastNameObjectA list of parsed names..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringGiven name (or first name) in Standard Mandarin Chinese.
{...}.lastNameStringSurname (or family name or last name) in Standard Mandarin Chinese.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Chinese Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseNameBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"赵丽颖"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "丽颖",
                "lastName": "赵"
            },
            "score": 4.64102036931541
        }
    ]
}

Split Chinese Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseNameBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"赵丽颖\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "丽颖",
                "lastName": "赵"
            },
            "score": 4.64102036931541
        }
    ]
}

Split Chinese Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "丽颖",
                "lastName": "赵"
            },
            "score": 4.64102036931541
        }
    ]
}

Split Chinese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseNameBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "赵丽颖"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "HAN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "赵丽颖",
            "nameParserType": "LN1FN1",
            "nameParserTypeAlt": null,
            "firstLastName": {
                "script": null,
                "id": null,
                "firstName": "丽颖",
                "lastName": "赵"
            },
            "score": 4.64102036931541
        }
    ]
}
information

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

  • Description : Identifie la structure (prénom et nom de famille) à partir d'un nom complet chinois écrit en Mandarin standard ou en pinyin.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Diviser Nom Chinois.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseName/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard ou en pinyin.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom complet renseigné.
nameParserTypeStringStructure la plus probable du nom complet.Structure du nom
nameParserTypeAltStringSeconde structure la plus probable du nom complet.Structure du nom
firstLastNameObjectA origined name..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique fourni.
{...}.firstNameStringGiven name (or first name) in Standard Mandarin Chinese.
{...}.lastNameStringSurname (or family name or last name) in Standard Mandarin Chinese.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Split Chinese Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseName/赵丽颖 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "丽颖",
        "lastName": "赵"
    },
    "score": 4.64102036931541
}

Split Chinese Name exemple de code pour java:

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

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

{
    "script": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "丽颖",
        "lastName": "赵"
    },
    "score": 4.64102036931541
}

Split Chinese Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseName/赵丽颖"

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": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "丽颖",
        "lastName": "赵"
    },
    "score": 4.64102036931541
}

Split Chinese Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseName/赵丽颖", {
  "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": "HAN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "赵丽颖",
    "nameParserType": "LN1FN1",
    "nameParserTypeAlt": null,
    "firstLastName": {
        "script": null,
        "id": null,
        "firstName": "丽颖",
        "lastName": "赵"
    },
    "score": 4.64102036931541
}

Noms Indiens

Namsor a développé une fonctionnalité étendue pour les noms indiens. Vous pourrez déterminer le groupe de caste ou la religion d'une personne à partir de son prénom et/ou de son nom. Il est également possible d'estimer l'État ou le territoire de l'Union d'origine directement à partir du nom.

Caste Nom Indien

La fonctionnalité Caste Nom Indien analyse un prénom et/ou un nom de famille et un État indien ou un territoire de l'Union de résidence pour déterminer le groupe de caste le plus probable de la personne. L'ajout du prénom et du nom de famille augmente la précision de la religion estimée. Si le prénom et le nom de famille ne sont pas clairement identifiables, veuillez utiliser la fonctionnalité Caste Nom Complet Indien.

  • Description : Détermine le groupe de caste à partir de prénoms et/ou noms de famille indiens et de territoires de résidence.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Caste Nom Indien.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence.
[{...}].idStringOptionelIdentifiant unique fourni.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés renrichi de leur groupe de caste.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].castegroupStringGroupe de caste le plus probable.Groupe de castes
[{...}].castegroupAltStringSecond groupe de caste le plus probable.Groupe de castes
[{...}].castegroupTopArrayListe des groupes de caste les plus probables, triés du plus probable au moins probable.Groupe de castes
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'castegroup' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'castegroup' ou que 'castegroupAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Caste Indian Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Akash","lastName":"Sharma","subdivisionIso":"IN-UP"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "firstName": "Akash",
            "lastName": "Sharma",
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
            "score": 11.127678155723578,
            "probabilityCalibrated": 0.7031015750163506,
            "probabilityAltCalibrated": 0.9535225800378421
        }
    ]
}

Caste Indian Name exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "firstName": "Akash",
            "lastName": "Sharma",
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
            "score": 11.127678155723578,
            "probabilityCalibrated": 0.7031015750163506,
            "probabilityAltCalibrated": 0.9535225800378421
        }
    ]
}

Caste Indian Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "firstName": "Akash",
            "lastName": "Sharma",
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
            "score": 11.127678155723578,
            "probabilityCalibrated": 0.7031015750163506,
            "probabilityAltCalibrated": 0.9535225800378421
        }
    ]
}

Caste Indian Name exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "firstName": "Akash",
            "lastName": "Sharma",
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
            "score": 11.127678155723578,
            "probabilityCalibrated": 0.7031015750163506,
            "probabilityAltCalibrated": 0.9535225800378421
        }
    ]
}
information

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

  • Description : Détermine le groupe de caste à partir d'un prénom et/ou nom de famille indien, et d'un territoire de résidence.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Caste Nom Indien.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndian/{subdivisionIso}/{firstName}/{lastName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
castegroupStringGroupe de caste le plus probable.Groupe de castes
castegroupAltStringSecond groupe de caste le plus probable.Groupe de castes
castegroupTopArrayListe des groupes de caste les plus probables, triés du plus probable au moins probable.Groupe de castes
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberLa probabilité calibrée que 'castegroup' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'castegroup' ou que 'castegroupAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Caste Indian Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndian/IN-UP/Akash/Sharma \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "firstName": "Akash",
    "lastName": "Sharma",
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
    "score": 11.127678155723578,
    "probabilityCalibrated": 0.7031015750163506,
    "probabilityAltCalibrated": 0.9535225800378421
}

Caste Indian Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndian/IN-UP/Akash/Sharma")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "LATIN",
    "firstName": "Akash",
    "lastName": "Sharma",
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
    "score": 11.127678155723578,
    "probabilityCalibrated": 0.7031015750163506,
    "probabilityAltCalibrated": 0.9535225800378421
}

Caste Indian Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndian/IN-UP/Akash/Sharma"

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",
    "firstName": "Akash",
    "lastName": "Sharma",
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
    "score": 11.127678155723578,
    "probabilityCalibrated": 0.7031015750163506,
    "probabilityAltCalibrated": 0.9535225800378421
}

Caste Indian Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndian/IN-UP/Akash/Sharma", {
  "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",
    "firstName": "Akash",
    "lastName": "Sharma",
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "SC", "ST"],
    "score": 11.127678155723578,
    "probabilityCalibrated": 0.7031015750163506,
    "probabilityAltCalibrated": 0.9535225800378421
}

Caste Nom Complet Indien

La fonctionnalité Caste Nom Complet Indien analyse un nom complet non divisé (prénom et nom de famille) et un État indien ou un territoire de l'Union de résidence pour déterminer le groupe de caste le plus probable de la personne.

  • Description : Détermine le groupe de caste à partir de noms complets non divisés (prénom et nom de famille) et de territoires de résidence.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Caste Nom Complet Indien.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFullBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence.
[{...}].idStringOptionelIdentifiant unique fourni.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés renrichi de leur groupe de caste.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet non divisé (prénom et nom de famille) renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].castegroupStringGroupe de caste le plus probable.Groupe de castes
[{...}].castegroupAltStringSecond groupe de caste le plus probable.Groupe de castes
[{...}].castegroupTopArrayListe des groupes de caste les plus probables, triés du plus probable au moins probable.Groupe de castes
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'castegroup' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'castegroup' ou que 'castegroupAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Caste Indian Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Akash Sharma","subdivisionIso":"IN-UP"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "name": "Akash Sharma",
            "score": 7.8984899727105295,
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
            "probabilityCalibrated": 0.6400351364066995,
            "probabilityAltCalibrated": 0.9559249062835251
        }
    ]
}

Caste Indian Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"Akash Sharma\",\"subdivisionIso\":\"IN-UP\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "name": "Akash Sharma",
            "score": 7.8984899727105295,
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
            "probabilityCalibrated": 0.6400351364066995,
            "probabilityAltCalibrated": 0.9559249062835251
        }
    ]
}

Caste Indian Full Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "name": "Akash Sharma",
            "score": 7.8984899727105295,
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
            "probabilityCalibrated": 0.6400351364066995,
            "probabilityAltCalibrated": 0.9559249062835251
        }
    ]
}

Caste Indian Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-UP"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "string",
            "name": "Akash Sharma",
            "score": 7.8984899727105295,
            "castegroup": "General/High Caste",
            "castegroupAlt": "General",
            "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
            "probabilityCalibrated": 0.6400351364066995,
            "probabilityAltCalibrated": 0.9559249062835251
        }
    ]
}
information

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

  • Description : Détermine le groupe de caste à partir d'un nom complet non divisé (prénom et nom de famille) Indien, et d'un territoire de résidence.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Caste Nom Complet Indien.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFull/{subdivisionIso}/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
nameStringNom complet non divisé (prénom et nom de famille) renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
castegroupStringGroupe de caste le plus probable.Groupe de castes
castegroupAltStringSecond groupe de caste le plus probable.Groupe de castes
castegroupTopArrayListe des groupes de caste les plus probables, triés du plus probable au moins probable.Groupe de castes
probabilityCalibratedNumberLa probabilité calibrée que 'castegroup' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'castegroup' ou que 'castegroupAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Caste Indian Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFull/IN-UP/Akash%20Sharma \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "name": "Akash Sharma",
    "score": 7.8984899727105295,
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
    "probabilityCalibrated": 0.6400351364066995,
    "probabilityAltCalibrated": 0.9559249062835251
}

Caste Indian Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFull/IN-UP/Akash%20Sharma")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "LATIN",
    "name": "Akash Sharma",
    "score": 7.8984899727105295,
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
    "probabilityCalibrated": 0.6400351364066995,
    "probabilityAltCalibrated": 0.9559249062835251
}

Caste Indian Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFull/IN-UP/Akash%20Sharma"

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",
    "name": "Akash Sharma",
    "score": 7.8984899727105295,
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
    "probabilityCalibrated": 0.6400351364066995,
    "probabilityAltCalibrated": 0.9559249062835251
}

Caste Indian Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFull/IN-UP/Akash%20Sharma", {
  "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",
    "name": "Akash Sharma",
    "score": 7.8984899727105295,
    "castegroup": "General/High Caste",
    "castegroupAlt": "General",
    "castegroupTop": ["General/High Caste", "General", "OBC", "ST", "SC"],
    "probabilityCalibrated": 0.6400351364066995,
    "probabilityAltCalibrated": 0.9559249062835251
}

Religion Nom Indien

La fonctionnalité Religion Nom Indien analyse le prénom, le nom de famille et un État indien ou un territoire de l'Union de résidence pour déterminer la religion la plus probable de la personne. L'ajout du prénom et du nom de famille augmente la précision de la religion estimée. Si le prénom et le nom de famille ne sont pas clairement identifiables, veuillez utiliser la fonctionnalité Religion Nom Complet Indien.

  • Description : Détermine la religion à partir de prénoms, noms de famille et territoires de résidence.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Religion Nom Indien.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence.
[{...}].idStringOptionelIdentifiant unique fourni.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés enrichi de leur religion.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].religionStringReligion la plus probable.Religions d'Inde
[{...}].religionAltStringSeconde religion la plus probable.Religions d'Inde
[{...}].religionsTopArrayTop des religions les plus probables, triées du plus probable au moins probable.Religions d'Inde
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'religion' a été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'religion' ou que la 'religionAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Religion Indian Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Akash","lastName":"Sharma","subdivisionIso":"IN-PB"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Akash",
            "lastName": "Sharma",
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Parsi", "Muslim"],
            "score": 15.842441054636446,
            "probabilityCalibrated": 0.8366121598622244,
            "probabilityAltCalibrated": 0.9418751496555294
        }
    ]
}

Religion Indian Name exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Akash",
            "lastName": "Sharma",
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Parsi", "Muslim"],
            "score": 15.842441054636446,
            "probabilityCalibrated": 0.8366121598622244,
            "probabilityAltCalibrated": 0.9418751496555294
        }
    ]
}

Religion Indian Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Akash",
            "lastName": "Sharma",
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Parsi", "Muslim"],
            "score": 15.842441054636446,
            "probabilityCalibrated": 0.8366121598622244,
            "probabilityAltCalibrated": 0.9418751496555294
        }
    ]
}

Religion Indian Name exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Akash",
      "lastName": "Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Akash",
            "lastName": "Sharma",
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Parsi", "Muslim"],
            "score": 15.842441054636446,
            "probabilityCalibrated": 0.8366121598622244,
            "probabilityAltCalibrated": 0.9418751496555294
        }
    ]
}
information

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

  • Description : Estime la religion à partir d'un prénom et/ou nom de famille Indiens et d'un territoire de résidence.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Religion Nom Indien.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndian/{subdivisionIso}/{firstName}/{lastName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
religionStringReligion la plus probable.Religions d'Inde
religionAltStringSeconde religion la plus probable.Religions d'Inde
religionsTopArrayTop des religions les plus probables, triées du plus probable au moins probable.Religions d'Inde
probabilityCalibratedNumberLa probabilité calibrée que 'religion' a été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'religion' ou que la 'religionAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Religion Indian Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndian/IN-UP/Akash/Sharma \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "firstName": "Akash",
    "lastName": "Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Indian Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndian/IN-UP/Akash/Sharma")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "LATIN",
    "firstName": "Akash",
    "lastName": "Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Indian Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndian/IN-UP/Akash/Sharma"

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",
    "firstName": "Akash",
    "lastName": "Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Indian Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndian/IN-UP/Akash/Sharma", {
  "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",
    "firstName": "Akash",
    "lastName": "Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Nom Complet Indien

La fonctionnalité Religion Nom Complet Indien analyse le nom complet (prénom et nom de famille) et un État indien ou un territoire de l'Union de résidence pour déterminer la religion la plus probable de la personne.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFullBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence.
[{...}].idStringOptionelIdentifiant unique fourni.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés enrichi de leur religion.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet non divisé (prénom et nom de famille) renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].religionStringReligion la plus probable.Religions d'Inde
[{...}].religionAltStringSeconde religion la plus probable.Religions d'Inde
[{...}].religionsTopArrayTop des religions les plus probables, triées du plus probable au moins probable.Religions d'Inde
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'religion' a été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'religion' ou que la 'religionAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Religion Indian Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Akash Sharma","subdivisionIso":"IN-PB"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Akash Sharma",
            "score": 11.205099735191228,
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
            "probabilityCalibrated": 0.9535569047307475,
            "probabilityAltCalibrated": 0.9896944325654494
        }
    ]
}

Religion Indian Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"Akash Sharma\",\"subdivisionIso\":\"IN-PB\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Akash Sharma",
            "score": 11.205099735191228,
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
            "probabilityCalibrated": 0.9535569047307475,
            "probabilityAltCalibrated": 0.9896944325654494
        }
    ]
}

Religion Indian Full Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Akash Sharma",
            "score": 11.205099735191228,
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
            "probabilityCalibrated": 0.9535569047307475,
            "probabilityAltCalibrated": 0.9896944325654494
        }
    ]
}

Religion Indian Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Akash Sharma",
      "subdivisionIso": "IN-PB"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Akash Sharma",
            "score": 11.205099735191228,
            "religion": "Hinduism",
            "religionAlt": "Jain",
            "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
            "probabilityCalibrated": 0.9535569047307475,
            "probabilityAltCalibrated": 0.9896944325654494
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFull/{subdivisionIso}/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
subdivisionIsoStringRequisÉtat ou territoire de l'Union (origine ou résidence), au format ISO 3166-2.
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
nameStringNom complet non divisé (prénom et nom de famille) renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
religionStringReligion la plus probable.Religions d'Inde
religionAltStringSeconde religion la plus probable.Religions d'Inde
religionsTopArrayTop des religions les plus probables, triées du plus probable au moins probable.Religions d'Inde
probabilityCalibratedNumberLa probabilité calibrée que 'religion' a été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'religion' ou que la 'religionAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Religion Indian Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFull/IN-UP/Akash%20Sharma \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "name": "Akash Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Indian Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFull/IN-UP/Akash%20Sharma")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

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

{
    "script": "LATIN",
    "name": "Akash Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Indian Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFull/IN-UP/Akash%20Sharma"

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",
    "name": "Akash Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Religion Indian Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFull/IN-UP/Akash%20Sharma", {
  "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",
    "name": "Akash Sharma",
    "score": 11.205099735191228,
    "religion": "Hinduism",
    "religionAlt": "Jain",
    "religionsTop": ["Hinduism", "Jain", "Buddhist", "Christian", "Sikh", "Muslim", "Parsi"],
    "probabilityCalibrated": 0.9535569047307475,
    "probabilityAltCalibrated": 0.9896944325654494
}

Subdivision Nom Indien

La fonctionnalité Subdivision Nom Indien analyse un prénom ou un nom de famille (ou les deux pour plus de précision) afin d'estimer l'État ou le territoire de l'Union le plus probable (dans la norme ISO 3166-2 alpha-2 format), avec une précision légèrement améliorée par rapport à la fonctionnalité Subdivision Nom Complet Indien.

  • Description : Détermine l'État indien ou le territoire de l'Union le plus probable d'un maximum de 100 prénoms et/ou noms de famille indiens.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Subdivision Nom Indien.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels.
[{...}].idStringOptionelIdentifiant unique fourni.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis avec leur contexte de subdivision géographique le plus probable.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].countryIso2StringPays de résidence le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].subClassificationStringÉtat indien ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
[{...}].subClassificationAltStringSecond État indien ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
[{...}].subclassificationTopArrayTop 10 des États indien ou territoires de l'Union de résidence les plus probables, triés du plus probable au moins probable.Subdivision Indienne
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberLa probabilité calibrée pour que la 'subClassification' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée pour 'subClassification' ou 'subClassificationAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Subclassification Indian Name exemple de code pour shell:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jannat",
      "lastName": "Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jannat",
            "lastName": "Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}

Subclassification Indian Name exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jannat",
      "lastName": "Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jannat",
            "lastName": "Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}

Subclassification Indian Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jannat",
      "lastName": "Rahmani"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jannat",
      "lastName": "Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jannat",
            "lastName": "Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}

Subclassification Indian Name exemple de code pour javascript:

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

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Jannat",
      "lastName": "Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Jannat",
            "lastName": "Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}
information

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

  • Description : Identifie l'État indien ou le territoire de l'Union le plus probable à partir d'un  prénom et/ou nom de famille indiens.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Subdivision Nom Indien.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndian/{firstName}/{lastName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
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é.
countryIso2StringPays de résidence le plus vraisemblable, au format ISO 3166-1 alpha-2 (always "IN").Pays de résidence
subClassificationStringÉtat indien ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
subClassificationAltStringSecond État indien ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
subclassificationTopArrayTop 10 des États indien ou territoires de l'Union de résidence les plus probables, triés du plus probable au moins probable.Subdivision Indienne
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberLa probabilité calibrée pour que la 'subClassification' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée pour 'subClassification' ou 'subClassificationAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Subclassification Indian Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndian/Amitabh/Bachchan \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "firstName": "Amitabh",
    "lastName": "Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subclassification Indian Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndian/Amitabh/Bachchan")
.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": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "firstName": "Amitabh",
    "lastName": "Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subclassification Indian Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndian/Amitabh/Bachchan"

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": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "firstName": "Amitabh",
    "lastName": "Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subclassification Indian Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndian/Amitabh/Bachchan", {
  "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": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "firstName": "Amitabh",
    "lastName": "Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subdivision Nom Complet Indien

La fonctionnalité Subdivision Nom Complet Indien analyse un nom complet non divisé (prénom et nom de famille) pour identifier l'État ou le territoire de l'Union le plus probable au format ISO 3166-2 alpha-2 .

information

Si le prénom et le nom de famille sont clairement identifiables, la fonction Subdivision Nom Indien sera légèrement plus précise.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFullBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets.
[{...}].idStringOptionelIdentifiant unique fourni.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis avec leur contexte de subdivision géographique le plus probable.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].countryIso2StringPays de résidence le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].subClassificationStringÉtat ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
[{...}].subClassificationAltStringSecond État ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
[{...}].subclassificationTopArrayTop 10 des territoires de résidence les plus probables dans l'État indien ou l'Union, classés du plus probable au moins probable.Subdivision Indienne
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberLa probabilité calibrée pour que la 'subClassification' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée pour 'subClassification' ou 'subClassificationAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Subclassification Indian Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Jannat Rahmani"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Jannat Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Jannat Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}

Subclassification Indian Full Name exemple de code pour java:

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

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Jannat Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Jannat Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}

Subclassification Indian Full Name exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Jannat Rahmani"
    }
  ]
}
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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Jannat Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Jannat Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}

Subclassification Indian Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Jannat Rahmani"
    }
  ]
})
});

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 :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Jannat Rahmani"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Jannat Rahmani",
            "countryIso2": "IN",
            "subClassification": "IN-CH",
            "subClassificationAlt": "IN-PY",
            "subclassificationTop": ["IN-CH", "IN-PY", "IN-UP", "IN-AN", "IN-RJ", "IN-JH", "IN-KL", "IN-BR", "IN-DL", "IN-UT"],
            "score": 2.5087208339960445,
            "probabilityCalibrated": 0.3684249074494664,
            "probabilityAltCalibrated": 0.4738687735374875
        }
    ]
}
information

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

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFull/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom complet renseigné.
countryIso2StringPays de résidence le plus vraisemblable, au format ISO 3166-1 alpha-2 (always "IN").Pays de résidence
subClassificationStringÉtat ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
subClassificationAltStringSecond État ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2.Subdivision Indienne
subclassificationTopArrayTop 10 des États ou territoires de l'Union de résidence les plus probables, triés du plus probable au moins probable.Subdivision Indienne
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberLa probabilité calibrée pour que la 'subClassification' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée pour 'subClassification' ou 'subClassificationAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Subclassification Indian Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFull/Amitabh%20Bachchan \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

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

{
    "script": "LATIN",
    "id": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "name": "Amitabh Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subclassification Indian Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFull/Amitabh%20Bachchan")
.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": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "name": "Amitabh Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subclassification Indian Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFull/Amitabh%20Bachchan"

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": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "name": "Amitabh Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Subclassification Indian Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFull/Amitabh%20Bachchan", {
  "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": "5dd784f2-d1d3-41b8-bba5-c064a836646b",
    "name": "Amitabh Bachchan",
    "countryIso2": "IN",
    "subClassification": "IN-CH",
    "subClassificationAlt": "IN-UT",
    "subclassificationTop": ["IN-CH", "IN-UT", "IN-AN", "IN-UP", "IN-DL", "IN-HR", "IN-RJ", "IN-HP", "IN-BR", "IN-KL"],
    "score": 8.02456285165782,
    "probabilityCalibrated": 0.5561082178046067,
    "probabilityAltCalibrated": 0.698831534498132
}

Numéro de téléphone

Le logiciel d'analyse de noms Namsor a été formé pour évaluer les numéros de téléphone formatés et non formatés. Il est capable de traiter un prénom, un nom et un numéro de téléphone afin d'établir son préfixe téléphonique et son indicatif de pays ainsi que de déterminer la structure du numéro de téléphone et de vérifier si elle est valide.

Formater Numéro Téléphone

La fonctionnalité Formater Numéro Téléphone analyse un prénom, un nom et un numéro de téléphone pour déterminer le préfixe téléphonique, le pays d'origine et le numéro de téléphone formaté.

  • 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).
  • Precision :Jauge de précision
  • Coût : 11 crédits par nom.
  • Tester : Fonctionnalité 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
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
        }
    ]
}
information

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

  • 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.
  • Precision :Jauge de précision
  • Coût : 11 crédits par nom.
  • Tester : Fonctionnalité Formater Numéro Téléphone.

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
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.
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 estimé à 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": null,
    "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.659341221254624
}

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": null,
    "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.659341221254624
}

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": null,
    "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.659341221254624
}

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": null,
    "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.659341221254624
}

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

La fonctionnalité Formater Numéro Téléphone (Geo) analyse un prénom, un nom, un numéro de téléphone et un contexte local pour déterminer le préfixe téléphonique le plus probable, le pays d'origine et le numéro de téléphone formaté, avec une précision améliorée par rapport à la fonctionnalité de base Formater Numéro Téléphone.

  • 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).
  • Precision :Jauge de précision
  • Coût : 11 crédits par nom.
  • Tester : Fonctionnalité 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
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
        }
    ]
}
information

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

  • 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.
  • Precision :Jauge de précision
  • Coût : 11 crédits par nom.
  • Tester : Fonctionnalité Formater Numéro Téléphone (Geo).

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
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é.
countryIso2StringRequisContexte local, 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.
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": null,
    "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": null,
    "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": null,
    "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": null,
    "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
}

Admin

Les terminaux d'administration vous permettent d'accéder à un large éventail d'outils d'administration. Accédez à votre historique d'utilisation de l'API, vérifiez l'état et la disponibilité des points de terminaison de Namsor ou interrogez les énumérateurs possibles pour un classificateur donné. Entre autres fonctionnalités, vous pouvez également définir vos options de confidentialité ou désactiver votre clé.

Version Logiciel

GET
  • Description : Renvoie la version actuelle du logiciel Namsor.
  • Coût : 1 crédit par nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/softwareVersion
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Réponse
NomTypeDescription
softwareNameAndVersionStringNom et version de l'API.
softwareVersionArrayVersion du logiciel, sous forme de tableau (majeur, mineur et patch).

Exemples d'intégration:

Software Version exemple de code pour shell:

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

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

{
    "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
    "softwareVersion": [
        2,
        0,
        14
    ]
}

Software Version exemple de code pour java:

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

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

{
    "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
    "softwareVersion": [
        2,
        0,
        14
    ]
}

Software Version exemple de code pour python:

import requests

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

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 :

{
    "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
    "softwareVersion": [
        2,
        0,
        14
    ]
}

Software Version exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/softwareVersion", {
  "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 :

{
    "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
    "softwareVersion": [
        2,
        0,
        14
    ]
}

Statut API

GET
  • Description : Renvoie la version actuelle du logiciel Namsor et l'État des classificateurs (services API).
  • Coût : 1 crédit par nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/apiStatus
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Réponse
NomTypeDescription
softwareVersionObjectInformations sur la version du logiciel.
{...}.softwareNameAndVersionStringNom et version de l'API.
{...}.softwareVersionArrayVersion du logiciel, sous forme de tableau (majeur, mineur et patch).
classifiersArray of objectsListe des classificateurs disponibles.
[{...}].classifierNameStringNom du classificateur / service.
[{...}].servingBooleanVrai si le classificateur traite des requêtes (a atteint un apprentissage minimal, ne s'arrête pas).
[{...}].learningBooleanVrai si le classificateur apprend.
[{...}].shuttingDownBooleanVrai si le classificateur est en train de s'arrêter.
[{...}].probabilityCalibratedBooleanVrai si le classificateur a terminé l'apprentissage initial et a des probabilités calibrées (lors de l'apprentissage initial, les probabilités calibrées seront égales à -1).

Exemples d'intégration:

Api Status exemple de code pour shell:

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

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

{
    "softwareVersion": {
        "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
        "softwareVersion": [
            2,
            0,
            14
        ]
    },
    "classifiers": [
        {
            "classifierName": "name_category",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": false
        },
        {
            "classifierName": "personalname_gender",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": true
        }
    ]
}

Api Status exemple de code pour java:

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

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

{
    "softwareVersion": {
        "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
        "softwareVersion": [
            2,
            0,
            14
        ]
    },
    "classifiers": [
        {
            "classifierName": "name_category",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": false
        },
        {
            "classifierName": "personalname_gender",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": true
        }
    ]
}

Api Status exemple de code pour python:

import requests

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

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 :

{
    "softwareVersion": {
        "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
        "softwareVersion": [
            2,
            0,
            14
        ]
    },
    "classifiers": [
        {
            "classifierName": "name_category",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": false
        },
        {
            "classifierName": "personalname_gender",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": true
        }
    ]
}

Api Status exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/apiStatus", {
  "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 :

{
    "softwareVersion": {
        "softwareNameAndVersion": "NamSorAPIv2.0.14B01",
        "softwareVersion": [
            2,
            0,
            14
        ]
    },
    "classifiers": [
        {
            "classifierName": "name_category",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": false
        },
        {
            "classifierName": "personalname_gender",
            "serving": true,
            "learning": true,
            "shuttingDown": false,
            "probabilityCalibrated": true
        }
    ]
}

Services Disponibles

GET
  • Description : Renvoie une liste des services API (classificateurs) et leurs coûts d'utilisation en crédits.
  • Coût : 1 crédit par nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/apiServices
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Réponse
NomTypeDescription
apiServicesArray of objectsListe des services API disponibles.
[{...}].serviceNameStringNom du classificateur / service.
[{...}].serviceGroupStringGroupe auquel appartient le classificateur/service.
[{...}].costInUnitsNumberCoût d'utilisation du service, en crédits.

Exemples d'intégration:

Available Services exemple de code pour shell:

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

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

{
    "apiServices": [
        {
            "serviceName": "name_category",
            "serviceGroup": "general",
            "costInUnits": 1
        },
        {
            "serviceName": "personalname_gender",
            "serviceGroup": "gender",
            "costInUnits": 1
        }
    ]
}

Available Services exemple de code pour java:

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

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

{
    "apiServices": [
        {
            "serviceName": "name_category",
            "serviceGroup": "general",
            "costInUnits": 1
        },
        {
            "serviceName": "personalname_gender",
            "serviceGroup": "gender",
            "costInUnits": 1
        }
    ]
}

Available Services exemple de code pour python:

import requests

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

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 :

{
    "apiServices": [
        {
            "serviceName": "name_category",
            "serviceGroup": "general",
            "costInUnits": 1
        },
        {
            "serviceName": "personalname_gender",
            "serviceGroup": "gender",
            "costInUnits": 1
        }
    ]
}

Available Services exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/apiServices", {
  "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 :

{
    "apiServices": [
        {
            "serviceName": "name_category",
            "serviceGroup": "general",
            "costInUnits": 1
        },
        {
            "serviceName": "personalname_gender",
            "serviceGroup": "gender",
            "costInUnits": 1
        }
    ]
}

Classes de Taxonomie

GET
  • Description : Renvoie une liste des énumérateurs possibles pour un classificateur donné.
  • Coût : 1 crédit par nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/taxonomyClasses/{classifierName}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
classifierNameStringRequisNom du classificateur.
Réponse
NomTypeDescription
classifierNameStringNom du classificateur soumis.
taxonomyClassesArrayÉnumérateurs possibles pour ce classificateur.

Exemples d'intégration:

Taxonomy Classes exemple de code pour shell:

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

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

{
    "classifierName": "personalname_gender",
    "taxonomyClasses": ["female", "male"]
}

Taxonomy Classes exemple de code pour java:

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

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

{
    "classifierName": "personalname_gender",
    "taxonomyClasses": ["female", "male"]
}

Taxonomy Classes exemple de code pour python:

import requests

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

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 :

{
    "classifierName": "personalname_gender",
    "taxonomyClasses": ["female", "male"]
}

Taxonomy Classes exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/taxonomyClasses/personalname_gender", {
  "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 :

{
    "classifierName": "personalname_gender",
    "taxonomyClasses": ["female", "male"]
}

Utilisation API

GET
  • Description : Renvoie des informations sur votre plan d'abonnement, la période de facturation et l'utilisation actuelle de l'API.
  • Coût : 1 crédit par nom.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/apiUsage
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Réponse
NomTypeDescription
subscriptionObjectInformation sur l'abonnement.
{...}.apiKeyStringVotre clé API Namsor.
{...}.planStartedNumberDate de début du forfait, au format horaire UNIX.
{...}.priorPlanStartedNumberDate et heure à laquelle l'utilisateur s'est abonné au forfait précédent.
{...}.planEndedNumberDate de fin du forfait, au format horaire UNIX.
{...}.taxRateNumberTaux d'imposition applicable au forfait.
{...}.planNameStringNom du forfait.
{...}.planBaseFeesKeyStringClé du plan actuel (comme dans le produit Stripe).
{...}.planStatusStringStatut du forfait.
{...}.planQuotaNumberNombre total de crédits associés à ce plan.
{...}.priceUSDNumberPrix en dollars américains ($).
{...}.priceOverageUSDNumberPrix de l'acquisition d'un credit en dollars américains ($).
{...}.priceNumberPrix dans la devise préférée de l'utilisateur.
{...}.priceOverageNumberPrix total de l'acquisition de crédits supplémentaires dans la devise préférée de l'utilisateur.
{...}.currencyStringLa devise préférée de l'utilisateur.
{...}.currencyFactorNumberPour USD, GBP, EUR - le facteur est 1.
{...}.stripeCustomerIdStringIdentifiant client Stripe unique.
{...}.stripeStatusStringStatut Stripe.
{...}.stripeSubscriptionStringIdentifiant d'abonnement Stripe.
{...}.userIdStringIdentifiant utilisateur unique.
billingPeriodObjectDétails de facturation.
{...}.apiKeyStringVotre clé API Namsor.
{...}.subscriptionStartedNumberDate de début de l'abonnement, au format horaire UNIX.
{...}.periodStartedNumberDate de début de la période d'abonnement, au format horaire UNIX.
{...}.periodEndedNumberDate de fin d'abonnement, au format horaire UNIX.
{...}.stripeCurrentPeriodEndNumberFin du plan actuel dans Stripe.
{...}.stripeCurrentPeriodStartNumberDébut du plan actuel dans Stripe.
{...}.billingStatusStringÉtat de la facturation pour la période en cours.
{...}.usageNumberNombre de crédits utilisés jusqu'à présent.
{...}.softLimitNumberLimite flexible actuelle.
{...}.hardLimitNumberLimite stricte actuelle.
overageExclTaxNumberMontant total d'acquisition des crédits supplémentaires hors taxe.
overageInclTaxNumberMontant total d'acquisition des crédits supplémentaires toutes taxes comprises.
overageCurrencyStringDevise du montant total d'acquisition des crédits supplémentaires.
overageQuantityNumberQuantité de crédits consommés supérieure au quota mensuel de l'abonnement en cours.

Exemples d'intégration:

Api Usage exemple de code pour shell:

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

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

{
    "subscription": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "planStarted": 1602705605199,
        "priorPlanStarted": 0,
        "planEnded": 0,
        "taxRate": 0,
        "planName": "BASIC",
        "planBaseFeesKey": "namsorapi_v2_BASIC_usd",
        "planStatus": "OPEN",
        "planQuota": 5000,
        "priceUSD": 0,
        "priceOverageUSD": 0.005,
        "price": 0,
        "priceOverage": 0.005,
        "currency": "usd",
        "currencyFactor": 1,
        "stripeCustomerId": null,
        "stripeStatus": null,
        "stripeSubscription": null,
        "userId": "GYUAUzTKPusJ3aqUH5gQte0dOQCr"
    },
    "billingPeriod": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "subscriptionStarted": 1602705635199,
        "periodStarted": 1618430435199,
        "periodEnded": 0,
        "stripeCurrentPeriodEnd": 0,
        "stripeCurrentPeriodStart": 0,
        "billingStatus": "OPEN",
        "usage": 34,
        "softLimit": 3000,
        "hardLimit": 5000
    },
    "overageExclTax": 0,
    "overageInclTax": 0,
    "overageCurrency": null,
    "overageQuantity": 0
}

Api Usage exemple de code pour java:

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

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

{
    "subscription": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "planStarted": 1602705605199,
        "priorPlanStarted": 0,
        "planEnded": 0,
        "taxRate": 0,
        "planName": "BASIC",
        "planBaseFeesKey": "namsorapi_v2_BASIC_usd",
        "planStatus": "OPEN",
        "planQuota": 5000,
        "priceUSD": 0,
        "priceOverageUSD": 0.005,
        "price": 0,
        "priceOverage": 0.005,
        "currency": "usd",
        "currencyFactor": 1,
        "stripeCustomerId": null,
        "stripeStatus": null,
        "stripeSubscription": null,
        "userId": "GYUAUzTKPusJ3aqUH5gQte0dOQCr"
    },
    "billingPeriod": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "subscriptionStarted": 1602705635199,
        "periodStarted": 1618430435199,
        "periodEnded": 0,
        "stripeCurrentPeriodEnd": 0,
        "stripeCurrentPeriodStart": 0,
        "billingStatus": "OPEN",
        "usage": 34,
        "softLimit": 3000,
        "hardLimit": 5000
    },
    "overageExclTax": 0,
    "overageInclTax": 0,
    "overageCurrency": null,
    "overageQuantity": 0
}

Api Usage exemple de code pour python:

import requests

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

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 :

{
    "subscription": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "planStarted": 1602705605199,
        "priorPlanStarted": 0,
        "planEnded": 0,
        "taxRate": 0,
        "planName": "BASIC",
        "planBaseFeesKey": "namsorapi_v2_BASIC_usd",
        "planStatus": "OPEN",
        "planQuota": 5000,
        "priceUSD": 0,
        "priceOverageUSD": 0.005,
        "price": 0,
        "priceOverage": 0.005,
        "currency": "usd",
        "currencyFactor": 1,
        "stripeCustomerId": null,
        "stripeStatus": null,
        "stripeSubscription": null,
        "userId": "GYUAUzTKPusJ3aqUH5gQte0dOQCr"
    },
    "billingPeriod": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "subscriptionStarted": 1602705635199,
        "periodStarted": 1618430435199,
        "periodEnded": 0,
        "stripeCurrentPeriodEnd": 0,
        "stripeCurrentPeriodStart": 0,
        "billingStatus": "OPEN",
        "usage": 34,
        "softLimit": 3000,
        "hardLimit": 5000
    },
    "overageExclTax": 0,
    "overageInclTax": 0,
    "overageCurrency": null,
    "overageQuantity": 0
}

Api Usage exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/apiUsage", {
  "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 :

{
    "subscription": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "planStarted": 1602705605199,
        "priorPlanStarted": 0,
        "planEnded": 0,
        "taxRate": 0,
        "planName": "BASIC",
        "planBaseFeesKey": "namsorapi_v2_BASIC_usd",
        "planStatus": "OPEN",
        "planQuota": 5000,
        "priceUSD": 0,
        "priceOverageUSD": 0.005,
        "price": 0,
        "priceOverage": 0.005,
        "currency": "usd",
        "currencyFactor": 1,
        "stripeCustomerId": null,
        "stripeStatus": null,
        "stripeSubscription": null,
        "userId": "GYUAUzTKPusJ3aqUH5gQte0dOQCr"
    },
    "billingPeriod": {
        "apiKey": "v7menlws2yo8r2mnm10f3uai53tmblth",
        "subscriptionStarted": 1602705635199,
        "periodStarted": 1618430435199,
        "periodEnded": 0,
        "stripeCurrentPeriodEnd": 0,
        "stripeCurrentPeriodStart": 0,
        "billingStatus": "OPEN",
        "usage": 34,
        "softLimit": 3000,
        "hardLimit": 5000
    },
    "overageExclTax": 0,
    "overageInclTax": 0,
    "overageCurrency": null,
    "overageQuantity": 0
}