Hash FNV-1a

Aucun appel réseau, sel aléatoire ni horloge murale n’entre dans le calcul : chaque chemin réussi est de l’arithmétique pure au prix de base publié $0.002.

Ce que signifie FNV-1a et comment les profils 32 et 64 bits diffèrent

L’entrée vide laisse le résidu égal à la base de décalage elle-même, que cet endpoint signale avec empty à true pour que les clients distinguent un blanc volontaire d’un champ manquant.

Contrat d’entrée, champs de réponse et comportement en entrée vide

La chaîne vide est autorisée exprès : l’identité mathématique de FNV-1a sur zéro octet est la base de décalage, et les pipelines qui empreignent des champs optionnels ont besoin d’un résidu stable plutôt qu’un échec dur. Lorsque la longueur source est nulle, la réponse met empty à true, hash à l’hex de la base pour la largeur choisie et bytes à zéro. Il n’y a pas de commutateur de mode pour FNV-1, MD5, SHA ou CRC : si vous avez besoin de ces digests, utilisez une capacité dédiée pour que chaque page corresponde à une seule intention de recherche et un slug SEO. Envoyez un corps JSON avec le champ obligatoire text égal à la chaîne que vous souhaitez hacher. Les alias input, value, s, string et content sont acceptés pour que les anciens formulaires et clients courts se lient encore. Le bits optionnel choisit la largeur : trente-deux (par défaut) ou soixante-quatre ; les alias width et bit_width sont acceptés, et les formes numériques comme textuelles fonctionnent. Les nombres finis et les grands entiers sont convertis en chaîne avant le hachage ; objets, tableaux, booléens, null, Infinity et NaN provoquent invalid_input et ne sont pas facturés. Pour une entrée non vide empty est false, bytes égale la longueur UTF-8, hash est le digest hex en minuscules sans préfixe zéro-x, et hash_int porte la même valeur comme entier non signé pour trente-deux bits ou comme chaîne décimale pour soixante-quatre bits afin que la plage non signée complète reste exacte en JSON. Algorithm est toujours l’étiquette FNV-1a ; offset_basis et prime répètent les chaînes de paramètres de la largeur sélectionnée pour que les exemples OpenAPI et les réponses de support citent le profil sans ambiguïté.

Où une API de hachage FNV-1a apporte de la valeur

Les développeurs collent de courtes clés, des fragments de configuration et des identifiants de cache dans un calculateur de hachage FNV-1a lorsqu’ils ont besoin d’un index de seau compact de trente-deux ou soixante-quatre bits qui correspond à un runtime de langage ou une note de protocole héritée. Les ingénieurs de support recalculent les digests à partir du texte du ticket pour confirmer qu’un dump collé n’a pas été tronqué ni réencodé en transit. Les laboratoires éducatifs utilisent le même endpoint pour montrer qu’un seul caractère modifié inverse de nombreux chiffres hex, illustrant le comportement d’avalanche sans introduire de machinerie cryptographique. Comme l’implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant ; une validation échouée ne consomme pas le solde. Gardez les charges sous le plafond de caractères documenté, traitez le champ hex comme cible de collage canonique, et vous obtenez des valeurs FNV-1a reproductibles pour la documentation, les SDK, les workers en bordure et les démonstrations de classe sans dresser un service de hachage séparé.