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
- L'URL du point de terminaison est: https://v2.namsor.com/NamSorAPIv2
- Tous les points de terminaison nécessitent une clé d'API.
- Ne partagez JAMAIS votre clé d'API.
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é.
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.
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: trueEn 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 :
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Origine.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/originBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-RELIGION-STATS | True | Optionel | Retourne 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets renseignés avec leurs pays d'origine. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].countryOrigin | String | Pays d'origine le plus probable, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].countryOriginAlt | String | Second pays d'origine le plus probable, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].countriesOriginTop | Array | Top 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 |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].regionOrigin | String | Région d'origine la plus probable. | Régions |
[{...}].topRegionOrigin | String | Région d'origine la plus probable (classification alternative). | Régions |
[{...}].subRegionOrigin | String | Sous-région d'origine la plus probable. | Sous régions |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le pays d'origine le plus probable (countryOrigin). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le second pays d'origine le plus probable (countryOriginAlt). | Religions |
[{...}].pct | Number | Pourcentage 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 },
],
}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".
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 :
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Origine Nom Complet.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/originFullBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-RELIGION-STATS | True | Optionel | Retourne 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés avec leurs pays d'origine. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet non divisé (prénom et nom de famille). | |
[{...}].countryOrigin | String | Pays d'origine le plus probable, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].countryOriginAlt | String | Second pays d'origine le plus probable, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].countriesOriginTop | Array | Top 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 |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].regionOrigin | String | Région d'origine la plus probable. | Régions |
[{...}].topRegionOrigin | String | Région d'origine la plus probable (classification alternative). | Régions |
[{...}].subRegionOrigin | String | Sous-région d'origine la plus probable. | Sous régions |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le pays d'origine le plus probable (countryOrigin). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le second pays d'origine le plus probable (countryOriginAlt). | Religions |
[{...}].pct | Number | Pourcentage 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
}
]
}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 :
- Coût : 20 crédits par nom.
- Tester : Fonctionnalité Diaspora.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-RELIGION-STATS | True | Optionel | Retourne 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Requis | Nom de famille. |
[{...}].countryIso2 | String | Optionel | Pays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis avec leurs ethnies estimées. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].ethnicityAlt | String | Seconde ethnie la plus probable. | Ethnicités et diasporas |
[{...}].ethnicity | String | Ethnie la plus probable. | Ethnicités et diasporas |
[{...}].lifted | Boolean | Indique 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. | |
[{...}].countryIso2 | String | Submitted Pays de résidence, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].ethnicitiesTop | Array | Top 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable. | Ethnicités et diasporas |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True). | |
[{...}].religion | String | Religion au sein de la diaspora la plus probable (ethnicity). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion au sein de la seconde diaspora la plus probable (ethnicityAlt). | Religions |
[{...}].pct | Number | Pourcentage 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 },
],
}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.
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 :
- Coût : 20 crédits par nom.
- Tester : Fonctionnalité Diaspora Nom Complet.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-RELIGION-STATS | True | Optionel | Retourne 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
[{...}].countryIso2 | String | Requis | Pays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets soumis avec leurs ethnies estimées. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].ethnicityAlt | String | Seconde ethnie la plus probable. | Ethnicités et diasporas |
[{...}].ethnicity | String | Ethnie la plus probable. | Ethnicités et diasporas |
[{...}].lifted | Boolean | Indique 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. | |
[{...}].countryIso2 | String | Submitted Pays de résidence, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].ethnicitiesTop | Array | Top 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable. | Ethnicités et diasporas |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True). | |
[{...}].religion | String | Religion au sein de la diaspora la plus probable (ethnicity). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion au sein de la seconde diaspora la plus probable (ethnicityAlt). | Religions |
[{...}].pct | Number | Pourcentage 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
}
]
}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
- Description : Estime l'ethnie 'raciale' US jusqu'à 100 prénoms et/ou noms de famille.
- Precision :
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Ethnie US.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-USRACEETHNICITY-TAXONOMY | USRACEETHNICITY-6CLASSES | Optionel | Recenseurs 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
[{...}].countryIso2 | String | Optionel | Pays de résidence, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés enrichis de leur ethnie 'raciale'. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].raceEthnicityAlt | String | Seconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census). | Ethnies raciales US |
[{...}].raceEthnicity | String | Ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census). | Ethnies raciales US |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].raceEthnicitiesTop | Array | Ethnies 'raciales' triées des plus probables au moins probables. | Ethnies raciales US |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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
- Description : Estime l'ethnie 'raciale' US jusqu'à 100 prénoms et/ou noms de famille, avec une précision améliorée grâce à un code postal de résidence.
- Precision :
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Ethnie US (ZIP).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-USRACEETHNICITY-TAXONOMY | USRACEETHNICITY-6CLASSES | Optionel | Recenseurs 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms de personnes avec leur pays de résidence et leur code postal. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
[{...}].countryIso2 | String | Optionel | Pays de résidence, au format ISO 3166-1 alpha-2. |
[{...}].zipCode | String | Requis | Code postal (5 chiffres) de résidence utilisé par le service postal des États-Unis (USPS). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés enrichis de leur ethnie 'raciale'. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].raceEthnicityAlt | String | Seconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census). | Ethnies raciales US |
[{...}].raceEthnicity | String | Ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census). | Ethnies raciales US |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].raceEthnicitiesTop | Array | Ethnies 'raciales' triées des plus probables au moins probables. | Ethnies raciales US |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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
Si le nom de famille et le prénom sont clairement identifiables, la fonction Ethnie US sera légèrement plus précise.
- Description : Estime l'ethnie 'raciale' US jusqu'à 100 noms complets non divisés.
- Precision :
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Ethnie US Nom Complet.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-USRACEETHNICITY-TAXONOMY | USRACEETHNICITY-6CLASSES | Optionel | Recenseurs 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
[{...}].countryIso2 | String | Optionel | Pays de résidence, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets renseignés enrichis de leur ethnie 'raciale'. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].raceEthnicityAlt | String | Seconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census). | Ethnies raciales US |
[{...}].raceEthnicity | String | Ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census). | Ethnies raciales US |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].raceEthnicitiesTop | Array | Ethnies 'raciales' triées des plus probables au moins probables. | Ethnies raciales US |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/countryFnLnBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-RELIGION-STATS | True | Optionel | Retourne 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés avec leurs pays de résidence. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].country | String | Pays de résidence le plus probable, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].countryAlt | String | Second pays de résidence le plsu vraisemblable, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].region | String | Région de résidence la plus probable. | Régions |
[{...}].topRegion | String | Région de résidence la plus probable (classification alternative). | Régions |
[{...}].subRegion | String | Sous-région de résidence la plus probable. | Sous régions |
[{...}].countriesTop | Array | Top 10 des pays de résidence les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable. | |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le pays de résidence le plus probable (country). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le second pays de résidence le plus probable (countryAlt). | Religions |
[{...}].pct | Number | Pourcentage 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
}
]
}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.
Si le nom de famille et le prénom sont clairement identifiables, la fonction Pays de Residence sera légèrement plus précise.
- Description : Renvoie le pays de résidence le plus probable parmi 100 noms complets non divisés.
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Pays de Residence Nom Complet.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatchEn-tête de requête
| Propriété | Valeurs | Requis | Description |
|---|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor | |
X-OPTION-RELIGION-STATS | True | Optionel | Retourne 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. |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets renseignés avec leurs pays de résidence. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].country | String | Pays de résidence le plus probable, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].countryAlt | String | Second pays de résidence le plsu vraisemblable, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].region | String | Région de résidence la plus probable. | Régions |
[{...}].topRegion | String | Région de résidence la plus probable (classification alternative). | Régions |
[{...}].subRegion | String | Sous-région de résidence la plus probable. | Sous régions |
[{...}].countriesTop | Array | Top 10 des pays de résidence les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable. | |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le pays de résidence le plus probable (country). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion dans le second pays de résidence le plus probable (countryAlt). | Religions |
[{...}].pct | Number | Pourcentage 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 },
],
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
corridorFromTo | Array of objects | Requis | Une liste de paires de noms, avec le code du pays (nameFrom -> nameTo). |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstLastNameGeoFrom | Object | Requis | . |
{...}.id | String | Optionel | Identifiant unique. |
{...}.firstName | String | Requis | . |
{...}.lastName | String | Requis | . |
{...}.countryIso2 | String | Requis | . |
[{...}].firstLastNameGeoTo | Object | Requis | . |
{...}.id | String | Optionel | Identifiant unique. |
{...}.firstName | String | Requis | . |
{...}.lastName | String | Requis | . |
{...}.countryIso2 | String | Requis | . |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
corridorFromTo | Array of objects | Une liste de paires de noms classifiés. | |
[{...}].id | String | Identifiant unique. | |
[{...}].firstLastNameGeoFromGender | Object | Données de genre pour l'expéditeur. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique. | |
{...}.firstName | String | . | |
{...}.lastName | String | . | |
{...}.likelyGender | String | . | Genres |
{...}.genderScale | Number | . | |
{...}.score | Number | . | |
{...}.probabilityCalibrated | Number | . | |
[{...}].firstLastNameGeoToGender | Object | Données de genre pour le destinataire. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique. | |
{...}.firstName | String | . | |
{...}.lastName | String | . | |
{...}.likelyGender | String | . | Genres |
{...}.genderScale | Number | . | |
{...}.score | Number | . | |
{...}.probabilityCalibrated | Number | . | |
[{...}].firstLastNameGeoFromOrigin | Object | Données d'origine pour l'expéditeur. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique. | |
{...}.firstName | String | . | |
{...}.lastName | String | . | |
{...}.countryOrigin | String | . | Pays d'origine |
{...}.countryOriginAlt | String | . | Pays d'origine |
{...}.countriesOriginTop | Array | . | Pays d'origine |
{...}.score | Number | . | |
{...}.regionOrigin | String | . | Régions |
{...}.topRegionOrigin | String | . | Régions |
{...}.subRegionOrigin | String | . | Sous régions |
{...}.probabilityCalibrated | Number | . | |
{...}.probabilityAltCalibrated | Number | . | |
[{...}].firstLastNameGeoToOrigin | Object | Données d'origine pour le destinataire. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique. | |
{...}.firstName | String | . | |
{...}.lastName | String | . | |
{...}.countryOrigin | String | . | Pays d'origine |
{...}.countryOriginAlt | String | . | Pays d'origine |
{...}.countriesOriginTop | Array | . | Pays d'origine |
{...}.score | Number | . | |
{...}.regionOrigin | String | . | Régions |
{...}.topRegionOrigin | String | . | Régions |
{...}.subRegionOrigin | String | . | Sous régions |
{...}.probabilityCalibrated | Number | . | |
{...}.probabilityAltCalibrated | Number | . | |
[{...}].firstLastNameGeoFromDiaspora | Object | Données de la diaspora pour l'expéditeur. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique. | |
{...}.firstName | String | . | |
{...}.lastName | String | . | |
{...}.score | Number | . | |
{...}.ethnicityAlt | String | . | Ethnicités et diasporas |
{...}.ethnicity | String | . | Ethnicités et diasporas |
{...}.lifted | Boolean | . | |
{...}.countryIso2 | String | . | Pays de résidence |
{...}.ethnicitiesTop | Array | . | Ethnicités et diasporas |
[{...}].firstLastNameGeoToDiaspora | Object | Données de la diaspora pour le destinataire. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique. | |
{...}.firstName | String | . | |
{...}.lastName | String | . | |
{...}.score | Number | . | |
{...}.ethnicityAlt | String | . | Ethnicités et diasporas |
{...}.ethnicity | String | . | Ethnicités et diasporas |
{...}.lifted | Boolean | . | |
{...}.countryIso2 | String | . | Pays de résidence |
{...}.ethnicitiesTop | Array | . | 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"]
}
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Requis | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis genrés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre (Geo).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Requis | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
[{...}].countryIso2 | String | Requis | Pays de résidence, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis genrés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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é.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre Nom Complet.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels complets. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets soumis genrés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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é.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre Nom Complet (Geo).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
[{...}].countryIso2 | String | Requis | Pays de résidence, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets soumis genrés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Type Nom.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
properNouns | Array of objects | Requis | Une liste de noms propres. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Un nom propre (personne, marque, etc.). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
properNouns | Array of objects | Une liste de noms propres avec leur type estimé. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom propre renseigné. | |
[{...}].commonType | String | Type le plus probable du nom propre. | Type du nom |
[{...}].commonTypeAlt | String | Second type le plus probable du nom propre. | Type du nom |
[{...}].score | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Type Nom (Geo).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeoBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
properNouns | Array of objects | Requis | Une liste de noms propres avec leur contexte géographique. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Un nom propre (personne, marque, etc.). |
[{...}].countryIso2 | String | Requis | Contexte géographique ou pays d'origine le plus probable, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
properNouns | Array of objects | Une liste de noms propres avec leur type estimé. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom propre renseigné. | |
[{...}].commonType | String | Type le plus probable du nom propre. | Type du nom |
[{...}].commonTypeAlt | String | Second type le plus probable du nom propre. | Type du nom |
[{...}].score | Number | Plus é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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets non divisés. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet (prénom et nom de famille). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets soumis divisés en structure de prénom et de nom de famille. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].nameParserType | String | Structure la plus probable du nom complet. | Structure du nom |
[{...}].nameParserTypeAlt | String | Seconde structure la plus probable du nom complet. | Structure du nom |
[{...}].firstLastName | Object | Nom complet divisé en prénom et nom de famille. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique fourni. | |
{...}.firstName | String | Prénom estimé. | |
{...}.lastName | String | Nom de famille estimé. | |
[{...}].score | Number | Plus é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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/parseNameGeoBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets non divisés avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet (prénom et nom de famille). |
[{...}].countryIso2 | String | Requis | Pays d'origine le plus probable, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets soumis divisés en structure de prénom et de nom de famille. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].nameParserType | String | Structure la plus probable du nom complet. | Structure du nom |
[{...}].nameParserTypeAlt | String | Seconde structure la plus probable du nom complet. | Structure du nom |
[{...}].firstLastName | Object | Nom complet divisé en prénom et nom de famille. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique fourni. | |
{...}.firstName | String | Prénom estimé. | |
{...}.lastName | String | Nom de famille estimé. | |
[{...}].score | Number | Plus é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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameLatinCandidatesBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms japonais personnels écrits en caractères kanji. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom japonais écrit en kanji. |
[{...}].lastName | String | Optionel | Nom de famille japonais écrit en kanji. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
namesAndMatchCandidates | Array of objects | Liste des noms soumis convertis en alphabet latin. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].orderOption | String | Ordre de tri pour 'matchCandidates'. | |
[{...}].matchCandidates | Array of objects | Liste des transcriptions possibles pour le nom indiqué. | |
[{...}].candidateName | String | Inferred transcription of the submitted name to Latin alphabet. | |
[{...}].probability | Number | Plus élevé implique un résultat plus fiable, allant de 0 à 1. | |
[{...}].predScoreGivenName | Number | Plus élevé implique un résultat plus fiable (pour le prénom). | |
[{...}].predScoreFamilyName | Number | Plus é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
}
]
}
]
}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.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Traduire Nom Japonais en Kanji.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameKanjiCandidatesBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms japonais personnels écrits en alphabet latin. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom japonais écrit en latin. |
[{...}].lastName | String | Optionel | Nom de famille japonais écrit en latin. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
namesAndMatchCandidates | Array of objects | Liste des noms soumis convertis en caractères Kanji. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].orderOption | String | Ordre de tri pour 'matchCandidates'. | |
[{...}].matchCandidates | Array of objects | Liste des transcriptions possibles pour le nom indiqué. | |
[{...}].candidateName | String | Transcription en kanji du nom soumis. | |
[{...}].probability | Number | Plus élevé implique un résultat plus fiable, allant de 0 à 1. | |
[{...}].predScoreGivenName | Number | Plus élevé implique un résultat plus fiable (pour le prénom). | |
[{...}].predScoreFamilyName | Number | Plus é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
}
]
}
]
}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.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Traduire Nom Japonais en Kanji (Genre).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameGenderKanjiCandidatesBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms japonais personnels écrits en alphabet latin avec un genre connu. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom japonais écrit en latin. |
[{...}].lastName | String | Optionel | Nom de famille japonais écrit en latin. |
[{...}].gender | String | Requis | Genre le plus probable (female ou male). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
namesAndMatchCandidates | Array of objects | Liste des noms soumis convertis en caractères Kanji. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].orderOption | String | Ordre de tri pour 'matchCandidates'. | |
[{...}].matchCandidates | Array of objects | Liste des transcriptions possibles pour le nom indiqué. | |
[{...}].candidateName | String | Transcription en kanji du nom soumis. | |
[{...}].probability | Number | Plus élevé implique un résultat plus fiable, allant de 0 à 1. | |
[{...}].predScoreGivenName | Number | Plus élevé implique un résultat plus fiable (pour le prénom). | |
[{...}].predScoreFamilyName | Number | Plus é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
}
]
}
]
}É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
https://v2.namsor.com/NamSorAPIv2/api2/json/japaneseNameMatchBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms japonais personnels en caractères kanji et en alphabet latin. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name1 | Object | Requis | . |
{...}.id | String | Optionel | Identifiant unique. |
{...}.firstName | String | Requis | Prénom japonais écrit en alphabet latin. |
{...}.lastName | String | Requis | Nom de famille japonais écrit en alphabet latin. |
[{...}].name2 | Object | Requis | . |
{...}.id | String | Optionel | Identifiant unique. |
{...}.name | String | Requis | Nom complet japonais (prénom et nom de famille) écrit en kanji. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
matchedNames | Array of objects | Liste des noms japonais soumis avec l'état de leur transcription. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].matchStatus | String | Statut de réussite de la transcription. | Statut de transcriptions |
[{...}].score | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre Nom Japonais.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms japonais. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Requis | Prénom japonais écrit en caractères latins ou kanji. |
[{...}].lastName | String | Optionel | Nom de famille japonais écrit en caractères latins ou kanji. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms japonais soumis genrés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre Nom Complet Japonais.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderJapaneseNameFullBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets japonais. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet japonais (prénom et nom de famille) écrit en kanji ou en latin. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets japonais soumis genrés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Diviser Nom Japonais.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/parseJapaneseNameBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets japonais non divisés. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet japonais (prénom et nom de famille) en alphabet kanji ou latin. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms japonais soumis divisés en structure de prénom et de nom de famille. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].nameParserType | String | Structure la plus probable du nom complet. | Structure du nom |
[{...}].nameParserTypeAlt | String | Seconde structure la plus probable du nom complet. | Structure du nom |
[{...}].firstLastName | Object | A list of parsed names.. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique fourni. | |
{...}.firstName | String | Prénom le plus probable. | |
{...}.lastName | String | Nom de famille le plus probable. | |
[{...}].score | Number | Plus é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
}
]
}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.
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
https://v2.namsor.com/NamSorAPIv2/api2/json/pinyinChineseNameBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets chinois (prénom et nom de famille) en chinois Mandarin standard. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis convertis en Pinyin (alphabet latin). | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].nameParserType | String | Structure la plus probable du nom complet. | Structure du nom |
[{...}].nameParserTypeAlt | String | Seconde structure la plus probable du nom complet. | Structure du nom |
[{...}].firstLastName | Object | A list of Pinyin names.. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique fourni. | |
{...}.firstName | String | Transcription la plus probable du prénom en pinyin. | |
{...}.lastName | String | Transcription la plus probable du nom de famille en pinyin. | |
[{...}].score | Number | Plus é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
}
]
}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.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Traduire Nom Chinois en Mandarin.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidatesBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms chinois écrits en pinyin (alphabet latin). |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom chinois écrit en pinyin. |
[{...}].lastName | String | Optionel | Nom de famille chinois écrit en pinyin. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
namesAndMatchCandidates | Array of objects | Liste des noms soumis convertis en Mandarin standard. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].orderOption | String | Ordre de tri pour 'matchCandidates'. | |
[{...}].matchCandidates | Array of objects | Liste des transcriptions possibles pour le nom indiqué. | |
[{...}].candidateName | String | Transcription en chinois mandarin standard du nom indiqué. | |
[{...}].probability | Number | Plus élevé implique un résultat plus fiable, allant de 0 à 1. | |
[{...}].predScoreGivenName | Number | Plus élevé implique un résultat plus fiable (pour le prénom). | |
[{...}].predScoreFamilyName | Number | Plus é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
}
]
}
]
}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.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Traduire Nom Chinois en Mandarin (Genre).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameCandidatesGenderBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms chinois écrits en pinyin (alphabet latin) avec leur genre. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom chinois écrit en pinyin. |
[{...}].lastName | String | Optionel | Nom de famille chinois écrit en pinyin. |
[{...}].gender | String | Requis | . |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
namesAndMatchCandidates | Array of objects | Liste des noms soumis convertis en Mandarin standard. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].orderOption | String | Ordre de tri pour 'matchCandidates'. | |
[{...}].matchCandidates | Array of objects | Liste des transcriptions possibles pour le nom indiqué. | |
[{...}].candidateName | String | Transcription en chinois mandarin standard du nom indiqué. | |
[{...}].probability | Number | Plus élevé implique un résultat plus fiable, allant de 0 à 1. | |
[{...}].predScoreGivenName | Number | Plus élevé implique un résultat plus fiable (pour le prénom). | |
[{...}].predScoreFamilyName | Number | Plus é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
}
]
}
]
}É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
https://v2.namsor.com/NamSorAPIv2/api2/json/chineseNameMatchBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms chinois écrits en pinyin et en chinois Mandarin standard. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name1 | Object | Requis | . |
{...}.id | String | Optionel | Identifiant unique. |
{...}.firstName | String | Requis | Nom de famille chinois écrit en pinyin. |
{...}.lastName | String | Requis | Prénom chinois écrit en pinyin. |
[{...}].name2 | Object | Requis | . |
{...}.id | String | Optionel | Identifiant unique. |
{...}.name | String | Requis | Nom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
matchedNames | Array of objects | Liste des noms chinois soumis avec l'état de leur transcription. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].matchStatus | String | Statut de réussite de la transcription. | Statut de transcriptions |
[{...}].score | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre Nom Chinois.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNamePinyinBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms chinois. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Requis | Prénom chinois écrit en pinyin ou en chinois Mandarin. |
[{...}].lastName | String | Optionel | Nom de famille chinois écrit en pinyin ou en chinois Mandarin. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms chinois enrichis de leur genre le plus probable. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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.
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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Genre Nom Complet Chinois.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/genderChineseNameBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets chinois écrits en Mandarin standard. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet chinois non divisé (prénom et nom de famille) écrit en Mandarin standard. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms chinois enrichis de leur genre le plus probable. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].likelyGender | String | Genre le plus probable. | Genres |
[{...}].genderScale | Number | Échelle de genre allant de -1 (masculin) à +1 (féminin). | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | Plus é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
}
]
}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 :
- Coût : 1 crédit par nom.
- Tester : Fonctionnalité Diviser Nom Chinois.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/parseChineseNameBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets chinois non divisés. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet chinois (prénom et nom de famille) écrit en chinois Mandarin standard ou en pinyin. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms chinois soumis divisés en structure de prénom et de nom de famille. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].nameParserType | String | Structure la plus probable du nom complet. | Structure du nom |
[{...}].nameParserTypeAlt | String | Seconde structure la plus probable du nom complet. | Structure du nom |
[{...}].firstLastName | Object | A list of parsed names.. | |
{...}.script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
{...}.id | String | Identifiant unique fourni. | |
{...}.firstName | String | Given name (or first name) in Standard Mandarin Chinese. | |
{...}.lastName | String | Surname (or family name or last name) in Standard Mandarin Chinese. | |
[{...}].score | Number | Plus é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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence. |
[{...}].id | String | Optionel | Identifiant unique fourni. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
[{...}].subdivisionIso | String | Requis | État ou territoire de l'Union (origine ou résidence), au format ISO 3166-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés renrichi de leur groupe de caste. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].castegroup | String | Groupe de caste le plus probable. | Groupe de castes |
[{...}].castegroupAlt | String | Second groupe de caste le plus probable. | Groupe de castes |
[{...}].castegroupTop | Array | Liste des groupes de caste les plus probables, triés du plus probable au moins probable. | Groupe de castes |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'castegroup' ait été deviné correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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 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
https://v2.namsor.com/NamSorAPIv2/api2/json/castegroupIndianFullBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence. |
[{...}].id | String | Optionel | Identifiant unique fourni. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
[{...}].subdivisionIso | String | Requis | État ou territoire de l'Union (origine ou résidence), au format ISO 3166-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés renrichi de leur groupe de caste. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet non divisé (prénom et nom de famille) renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].castegroup | String | Groupe de caste le plus probable. | Groupe de castes |
[{...}].castegroupAlt | String | Second groupe de caste le plus probable. | Groupe de castes |
[{...}].castegroupTop | Array | Liste des groupes de caste les plus probables, triés du plus probable au moins probable. | Groupe de castes |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'castegroup' ait été deviné correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence. |
[{...}].id | String | Optionel | Identifiant unique fourni. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
[{...}].subdivisionIso | String | Requis | État ou territoire de l'Union (origine ou résidence), au format ISO 3166-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés enrichi de leur religion. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].religion | String | Religion la plus probable. | Religions d'Inde |
[{...}].religionAlt | String | Seconde religion la plus probable. | Religions d'Inde |
[{...}].religionsTop | Array | Top des religions les plus probables, triées du plus probable au moins probable. | Religions d'Inde |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'religion' a été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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 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.
- Description : Détermine la religion à partir de noms complets (non divisés) indiens et de territoires de résidence.
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Religion Nom Complet Indien.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/religionIndianFullBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms de personnes avec leur État ou territoire de l'Union d'origine ou de résidence. |
[{...}].id | String | Optionel | Identifiant unique fourni. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
[{...}].subdivisionIso | String | Requis | État ou territoire de l'Union (origine ou résidence), au format ISO 3166-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms renseignés enrichi de leur religion. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet non divisé (prénom et nom de famille) renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].religion | String | Religion la plus probable. | Religions d'Inde |
[{...}].religionAlt | String | Seconde religion la plus probable. | Religions d'Inde |
[{...}].religionsTop | Array | Top des religions les plus probables, triées du plus probable au moins probable. | Religions d'Inde |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'religion' a été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels. |
[{...}].id | String | Optionel | Identifiant unique fourni. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Optionel | Nom de famille. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis avec leur contexte de subdivision géographique le plus probable. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].countryIso2 | String | Pays de résidence le plus probable, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].subClassification | String | État indien ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2. | Subdivision Indienne |
[{...}].subClassificationAlt | String | Second État indien ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2. | Subdivision Indienne |
[{...}].subclassificationTop | Array | Top 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 |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | La probabilité calibrée pour que la 'subClassification' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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 .
Si le prénom et le nom de famille sont clairement identifiables, la fonction Subdivision Nom Indien sera légèrement plus précise.
- Description : Identifie l'État indien ou le territoire de l'Union le plus probable d'un maximum de 100 noms complets (non diviés) indiens.
- Coût : 10 crédits par nom.
- Tester : Fonctionnalité Subdivision Nom Complet Indien.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/subclassificationIndianFullBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets. |
[{...}].id | String | Optionel | Identifiant unique fourni. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis avec leur contexte de subdivision géographique le plus probable. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].countryIso2 | String | Pays de résidence le plus probable, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].subClassification | String | État ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2. | Subdivision Indienne |
[{...}].subClassificationAlt | String | Second État ou territoire de l'Union de résidence le plus probable, au format ISO 3166-2 alpha-2. | Subdivision Indienne |
[{...}].subclassificationTop | Array | Top 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 |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].probabilityCalibrated | Number | La probabilité calibrée pour que la 'subClassification' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La 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
}
]
}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 :
- Coût : 11 crédits par nom.
- Tester : Fonctionnalité Formater Numéro Téléphone.
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNamesWithPhoneNumbers | Array of objects | Requis | Une liste de prénoms, noms de famille et numéros de téléphone. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom du propriétaire du numéro de téléphone. |
[{...}].lastName | String | Optionel | Nom de famille du propriétaire du numéro de téléphone. |
[{...}].phoneNumber | String | Requis | Numéro de téléphone, formaté ou non formaté. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNamesWithPhoneNumbers | Array of objects | Numéros de téléphone formatés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].internationalPhoneNumberVerified | String | Numéro de téléphone vérifié positivement, au format E.164 (selon LibPhoneNumber). | |
[{...}].phoneCountryIso2Verified | String | Pays 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 |
[{...}].phoneCountryCode | Number | Indicatif d'appel du pays le plus probable. | Préfixe téléphonique |
[{...}].phoneCountryCodeAlt | Number | Second indicatif d'appel du pays le plus probable. | Préfixe téléphonique |
[{...}].phoneCountryIso2 | String | Pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].phoneCountryIso2Alt | String | Second pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].originCountryIso2 | String | Pays de résidence le plus probable à partir du nom, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].originCountryIso2Alt | String | Second pays de résidence le plus probable estimé à partir du nom, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].phoneNumber | String | Numéro de téléphone soumis. | |
[{...}].verified | Boolean | Indique si le numéro de téléphone peut être vérifié positivement à l'aide de LibPhoneNumber. | |
[{...}].score | Number | Plus é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
}
]
}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 :
- Coût : 11 crédits par nom.
- Tester : Fonctionnalité Formater Numéro Téléphone (Geo).
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/phoneCodeGeoBatchEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNamesWithPhoneNumbers | Array of objects | Requis | Une liste de prénoms, noms de famille et numéros de téléphone. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom du propriétaire du numéro de téléphone. |
[{...}].lastName | String | Optionel | Nom de famille du propriétaire du numéro de téléphone. |
[{...}].phoneNumber | String | Requis | Numéro de téléphone, formaté ou non formaté. |
[{...}].countryIso2 | String | Requis | Pays d'origine le plus probable, au format ISO 3166-1 alpha-2. |
[{...}].countryIso2Alt | String | Optionel | Second pays d'origine le plus probable, au format ISO 3166-1 alpha-2. |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNamesWithPhoneNumbers | Array of objects | Numéros de téléphone formatés. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].internationalPhoneNumberVerified | String | Numéro de téléphone vérifié positivement, au format E.164 (selon LibPhoneNumber). | |
[{...}].phoneCountryIso2Verified | String | Pays 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 |
[{...}].phoneCountryCode | Number | Indicatif d'appel du pays le plus probable. | Préfixe téléphonique |
[{...}].phoneCountryCodeAlt | Number | Second indicatif d'appel du pays le plus probable. | Préfixe téléphonique |
[{...}].phoneCountryIso2 | String | Pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].phoneCountryIso2Alt | String | Second pays d'origine le plus probable du numéro de téléphone, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].originCountryIso2 | String | Pays de résidence le plus probable à partir du nom, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].originCountryIso2Alt | String | Second pays de résidence le plus probable estimé à partir du nom, au format ISO 3166-1 alpha-2. | Pays d'origine |
[{...}].phoneNumber | String | Numéro de téléphone soumis. | |
[{...}].verified | Boolean | Indique si le numéro de téléphone peut être vérifié positivement à l'aide de LibPhoneNumber. | |
[{...}].score | Number | Plus é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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/softwareVersionEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Description |
|---|---|---|
softwareNameAndVersion | String | Nom et version de l'API. |
softwareVersion | Array | Version 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
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/apiStatusEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Description |
|---|---|---|
softwareVersion | Object | Informations sur la version du logiciel. |
{...}.softwareNameAndVersion | String | Nom et version de l'API. |
{...}.softwareVersion | Array | Version du logiciel, sous forme de tableau (majeur, mineur et patch). |
classifiers | Array of objects | Liste des classificateurs disponibles. |
[{...}].classifierName | String | Nom du classificateur / service. |
[{...}].serving | Boolean | Vrai si le classificateur traite des requêtes (a atteint un apprentissage minimal, ne s'arrête pas). |
[{...}].learning | Boolean | Vrai si le classificateur apprend. |
[{...}].shuttingDown | Boolean | Vrai si le classificateur est en train de s'arrêter. |
[{...}].probabilityCalibrated | Boolean | Vrai 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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/apiServicesEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Description |
|---|---|---|
apiServices | Array of objects | Liste des services API disponibles. |
[{...}].serviceName | String | Nom du classificateur / service. |
[{...}].serviceGroup | String | Groupe auquel appartient le classificateur/service. |
[{...}].costInUnits | Number | Coû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
}
]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/taxonomyClasses/{classifierName}En-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Requis | Description |
|---|---|---|---|
classifierName | String | Requis | Nom du classificateur. |
| Nom | Type | Description |
|---|---|---|
classifierName | String | Nom du classificateur soumis. |
taxonomyClasses | Array | É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"]
}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
https://v2.namsor.com/NamSorAPIv2/api2/json/apiUsageEn-tête de requête
| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
| Nom | Type | Description |
|---|---|---|
subscription | Object | Information sur l'abonnement. |
{...}.apiKey | String | Votre clé API Namsor. |
{...}.planStarted | Number | Date de début du forfait, au format horaire UNIX. |
{...}.priorPlanStarted | Number | Date et heure à laquelle l'utilisateur s'est abonné au forfait précédent. |
{...}.planEnded | Number | Date de fin du forfait, au format horaire UNIX. |
{...}.taxRate | Number | Taux d'imposition applicable au forfait. |
{...}.planName | String | Nom du forfait. |
{...}.planBaseFeesKey | String | Clé du plan actuel (comme dans le produit Stripe). |
{...}.planStatus | String | Statut du forfait. |
{...}.planQuota | Number | Nombre total de crédits associés à ce plan. |
{...}.priceUSD | Number | Prix en dollars américains ($). |
{...}.priceOverageUSD | Number | Prix de l'acquisition d'un credit en dollars américains ($). |
{...}.price | Number | Prix dans la devise préférée de l'utilisateur. |
{...}.priceOverage | Number | Prix total de l'acquisition de crédits supplémentaires dans la devise préférée de l'utilisateur. |
{...}.currency | String | La devise préférée de l'utilisateur. |
{...}.currencyFactor | Number | Pour USD, GBP, EUR - le facteur est 1. |
{...}.stripeCustomerId | String | Identifiant client Stripe unique. |
{...}.stripeStatus | String | Statut Stripe. |
{...}.stripeSubscription | String | Identifiant d'abonnement Stripe. |
{...}.userId | String | Identifiant utilisateur unique. |
billingPeriod | Object | Détails de facturation. |
{...}.apiKey | String | Votre clé API Namsor. |
{...}.subscriptionStarted | Number | Date de début de l'abonnement, au format horaire UNIX. |
{...}.periodStarted | Number | Date de début de la période d'abonnement, au format horaire UNIX. |
{...}.periodEnded | Number | Date de fin d'abonnement, au format horaire UNIX. |
{...}.stripeCurrentPeriodEnd | Number | Fin du plan actuel dans Stripe. |
{...}.stripeCurrentPeriodStart | Number | Début du plan actuel dans Stripe. |
{...}.billingStatus | String | État de la facturation pour la période en cours. |
{...}.usage | Number | Nombre de crédits utilisés jusqu'à présent. |
{...}.softLimit | Number | Limite flexible actuelle. |
{...}.hardLimit | Number | Limite stricte actuelle. |
overageExclTax | Number | Montant total d'acquisition des crédits supplémentaires hors taxe. |
overageInclTax | Number | Montant total d'acquisition des crédits supplémentaires toutes taxes comprises. |
overageCurrency | String | Devise du montant total d'acquisition des crédits supplémentaires. |
overageQuantity | Number | Quantité 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
}