ForHosting KIT · Outils pour développeurs

Chiffre de contrôle ID Hong Kong

Le corps A123456 reçoit le chiffre de contrôle 3 : le numéro complet s'écrit donc A123456(3). Calculez ce dernier caractère ou vérifiez un numéro entier avant d'enregistrer une fiche ou d'accepter un formulaire, et repérez les fautes de frappe comme A123456(4). Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

HKID: A123456
Mode de calcul: Compute

Vous obtenez

Entrée: A123456
Chiffre de contrôle: 3
Avec chiffre de contrôle: A1234563
Formaté: A123456(3)

Les numéros de carte d'identité de Hong Kong se terminent par un unique caractère de contrôle dérivé d'une pondération fixe modulo onze sur les lettres du préfixe et les six chiffres du corps. Ce caractère final est un chiffre de zéro à neuf ou la lettre A, et il est généralement imprimé entre parenthèses après le corps — par exemple A123456(3) ou G123456(A). Une lettre mal saisie, un chiffre du corps permuté ou une erreur d'OCR sur un formulaire brisent souvent la somme de contrôle, de sorte que valider le chiffre de contrôle avant d'enregistrer un profil, d'accepter un document KYC ou d'importer un registre détecte tôt de nombreuses fautes de frappe. Cette capacité calcule le chiffre de contrôle de l'ID de Hong Kong pour un préfixe d'une ou deux lettres plus six chiffres, ou valide un numéro complet qui inclut déjà le caractère final, et signale une entrée incorrecte au lieu de supprimer silencieusement la ponctuation.

Ce qu'est le chiffre de contrôle de l'ID de Hong Kong et comment fonctionnent les poids modulo onze

Un numéro de carte d'identité permanente ou non permanente de Hong Kong est composé d'un ou deux caractères alphabétiques de préfixe, de six chiffres décimaux formant le corps, et d'un caractère de contrôle final. Le schéma du Département de l'immigration associe chaque lettre à un nombre (A vaut dix, B onze, jusqu'à Z qui vaut trente-cinq) et, lorsque la carte utilise un préfixe d'une seule lettre, insère un espace initial valant trente-six afin que chaque somme couvre toujours huit positions.

Ces huit valeurs sont multipliées par les poids fixes neuf, huit, sept, six, cinq, quatre, trois et deux de gauche à droite. Les produits sont additionnés, le total est réduit modulo onze, et onze moins ce reste devient le contrôle : si le résultat est onze le caractère imprimé est zéro ; s'il est dix le caractère imprimé est la lettre A ; sinon le résultat est le chiffre décimal de contrôle lui-même. Lorsqu'une personne saisit A123456(3) comme A123456(4), la somme pondérée ne correspond plus et la validation échoue.

La même règle détecte de nombreuses substitutions d'un seul caractère dans les onboarding RH, les dossiers KYC bancaires, les formulaires télécom et les fichiers d'inscription scolaire où les opérateurs ressaisissent des numéros depuis des cartes plastiques ou des scans de passeport. Cet outil applique cette pondération publique sur des lettres majuscules normalisées et des chiffres après gestion optionnelle des espaces et parenthèses.

Il n'interroge aucune base gouvernementale, ne prouve pas qu'une personne existe et ne décode pas l'âge ni le statut de résidence à partir du corps — seulement que la chaîne de caractères est cohérente sous l'algorithme de contrôle publié. Par rapport à Luhn modulo dix des cartes de paiement, le schéma HKID utilise des valeurs de lettres et le modulo onze avec le sentinelle A, de sorte que vous ne devez pas réutiliser un validateur Luhn sur les champs d'ID de Hong Kong.

Par rapport aux aides à l'ID résident de Chine continentale ou de Macao, la règle de Hong Kong est propre à ce préfixe d'une ou deux lettres, ce corps de six chiffres et ce vecteur de poids à huit positions. Savoir quel schéma vous devez utiliser évite une fausse confiance lorsqu'un utilitaire général de chiffre de contrôle accepte une chaîne de chiffres qui n'est pas un numéro de carte d'identité de Hong Kong bien formé.

Où les chiffres de contrôle de l'ID de Hong Kong s'intègrent aux flux KYC, RH et commerciaux

Les parcours de connaissance client et d'ouverture de compte dans les banques, courtiers et applications fintech stockent un numéro de carte d'identité de Hong Kong sur chaque profil de résident éligible ; un seul chiffre mal saisi à l'onboarding peut envoyer des documents de conformité à la mauvaise personne ou faire échouer une correspondance ultérieure avec un scan.

Les employeurs, établissements scolaires et opérateurs télécom associent un HKID à chaque personne dans des imports CSV par lots ; les erreurs de corps décalées d'un et les parenthèses manquantes sont fréquentes lors d'une resaisie depuis le papier, et un chiffre de contrôle les détecte avant la première paie ou l'activation d'une SIM.

Les équipes produit qui exposent déjà des outils généraux de contrôle Luhn ou ISO 7064 doivent tout de même utiliser cette capacité spécifique à Hong Kong pour les champs HKID afin que le mappage des lettres, le remplissage par espace du préfixe d'une lettre, les bornes de longueur et le format de A comme dix correspondent au domaine.

Ne traitez pas un chiffre de contrôle d'ID de Hong Kong valide comme une preuve que la personne est correctement identifiée, détient une carte valide, est résidente ou figure dans un registre officiel — cela prouve seulement que la chaîne de caractères est cohérente sous l'algorithme de contrôle modulo onze de la carte d'identité de Hong Kong.

Cas d’usage

Auditer les colonnes d'ID de Hong Kong dans les fichiers partenaires et de paie

Validez en lot chaque HKID d'un import CSV et mettez en quarantaine les lignes dont le caractère de contrôle ne correspond plus à la valeur attendue recalculée.

Questions fréquentes

Que se passe-t-il avec une longueur, des lettres ou une ponctuation incorrectes ?

Fournissez 1–2 lettres et six chiffres, éventuellement un contrôle 0–9 ou A. Compute n'exige que le corps ; validate exige l'ID complet. Les tâches de validation en échec ne sont pas facturées.

L'outil de chiffre de contrôle de l'ID de Hong Kong est-il gratuit ?

L'outil du navigateur est gratuit et s'exécute localement.

Comment le chiffre de contrôle HKID est-il calculé ?

Les lettres deviennent des nombres (A vaut 10, Z vaut 35) et un préfixe d'une seule lettre reçoit devant lui un espace valant 36. Les huit valeurs sont multipliées par 9 jusqu'à 2 et additionnées ; 11 moins le reste de la division par 11 donne le contrôle : 10 s'écrit A, 11 s'écrit 0.

Pourquoi certains numéros de Hong Kong finissent-ils par A ?

Parce que lorsque le calcul donne 10, le caractère de contrôle s'écrit avec la lettre A au lieu d'un nombre à deux chiffres, comme dans G123456(A). Tout autre résultat s'affiche sous forme de chiffre.

Un chiffre de contrôle correct prouve-t-il que la carte est authentique ?

Non. Il indique seulement que les caractères respectent la règle de contrôle publiée. Aucune base officielle n'est consultée, et l'outil ne révèle ni l'âge, ni le statut de résidence, ni l'existence de la personne.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/enc/hkid

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/enc/hkid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hkid":"A123456"}'

const res = await fetch("https://api.kit.forhosting.com/enc/hkid", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "hkid": "A123456"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/hkid",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "hkid": "A123456"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/hkid", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"hkid":"A123456"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"hkid":"A123456"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/hkid", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "hkid": "A123456"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.hkid",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Utilisez-la gratuitement dans le navigateur ou appelez l'API KIT au prix publié ; les deux chemins exécutent la même arithmétique déterministe sans requête réseau et sans registre de titulaires réels.

Comment calculer un chiffre de contrôle ou valider un ID de Hong Kong complet

Envoyez un champ hkid contenant une ou deux lettres de A à Z, six chiffres de zéro à neuf, et éventuellement un caractère de contrôle final de zéro à neuf ou A. Le mode validate attend un numéro complet incluant le caractère de contrôle final, soit entre parenthèses (A123456(3), G123456(A)), soit collé comme caractère final (A1234563, G123456A). Les chaînes vides, l'absence de hkid, les valeurs de mode invalides, les mauvais nombres de lettres ou de chiffres et les requêtes compute qui incluent déjà un caractère de contrôle échouent avant toute somme pondérée et ne sont pas facturées. Préférez compute lorsque vous construisez une chaîne d'ID à partir d'un préfixe connu et d'un corps de six chiffres ; préférez validate lorsqu'un utilisateur, un fichier partenaire ou une carte scannée fournit un numéro complet et que vous avez besoin d'un filtre booléen avant une recherche dans un référentiel interne. Les espaces autour de la valeur sont tronqués ; toute autre ponctuation, les minuscules (normalisées en majuscules), les doubles parenthèses ou les symboles intégrés sont rejetés comme entrée mal formée avec invalid_input afin que vous n'acceptiez jamais une valeur nettoyée en silence. Le mode compute est le mode par défaut : fournissez uniquement le corps sans le caractère de contrôle (par exemple A123456, G123456 ou XA123456), et le moteur renvoie check_digit sous forme de chaîne d'un caractère, with_check comme le corps plus ce caractère sans parenthèses, et formatted sous la forme familière BODY(CHECK) utilisée sur les cartes et formulaires. La réponse indique valid true lorsque le caractère de contrôle recalculé correspond à celui fourni, et inclut toujours check_digit, expected_check_digit, body sans le contrôle, with_check et formatted pour un affichage cohérent. Comme le chemin est un parse pur sans horloge, source aléatoire ni réseau, la même entrée produit toujours le même JSON sur l'outil gratuit du navigateur et sur l'API. À $0.002 par requête réussie vous pouvez filtrer des imports de registres en masse, des formulaires d'onboarding et des jobs ETL sans négocier un palier sur mesure.

Où les chiffres de contrôle de l'ID de Hong Kong s'intègrent aux flux KYC, RH et commerciaux

Le mode validate à l'entrée bloque l'enregistrement lorsque valid est false et peut afficher expected_check_digit pour que le guichetier corrige le formulaire avant d'écrire l'enregistrement.

Cas d'intégration

Contrôler les champs HKID sur les formulaires d'onboarding et KYC

Lorsqu'un utilisateur soumet un ID de Hong Kong complet, appelez le mode validate et bloquez l'enregistrement si valid est false, en affichant expected_check_digit pour corriger une seule faute de frappe avant d'écrire le profil.

Calculer les chiffres de contrôle lors de la complétion de chaînes d'ID

À partir d'un préfixe de lettres et d'un corps de six chiffres, appelez le mode compute et stockez with_check ou formatted afin que chaque nouvelle chaîne de type HKID porte le caractère final correct avant impression ou export.

Questions techniques

Qu'est-ce que le chiffre de contrôle de l'ID de Hong Kong ?

C'est un unique caractère final (0–9 ou A) calculé avec les poids 9..2 sur les valeurs de lettres (A=10..Z=35, espace initial=36 pour les préfixes d'une lettre) et six chiffres du corps, puis modulo 11, de sorte que la plupart des fautes d'un caractère cassent la somme de contrôle.

Comment calculer un chiffre de contrôle d'ID de Hong Kong avec cette API ?

Faites un POST avec hkid égal au corps seul (une ou deux lettres plus six chiffres, p. ex. A123456) et mode compute (ou omettez mode). La réponse inclut check_digit, with_check et formatted sous la forme BODY(CHECK).

Comment valider un ID de Hong Kong complet ?

Faites un POST avec le numéro complet y compris le caractère de contrôle (p. ex. A123456(3) ou G123456(A)) et mode validate. La réponse inclut valid, check_digit, expected_check_digit, body et formatted.

Consulter la documentation complète du KIT →