Clé de signature d'anagrammes

Une entrée vide échoue avec invalid_input au lieu d'inventer une clé creuse, tandis que les sacs de ponctuation seule en mode letters-only réussissent avec une signature vide encore utilisable comme clé de groupe.

Qu'est-ce qu'une signature d'anagramme et pourquoi le tri des lettres suffit

Lorsque vous avez besoin d'un multiensemble brut de caractères pour des sacs exacts—espaces, chiffres et ponctuation compris—fixez letters_only à false et éventuellement case_sensitive à true pour que chaque unité de code participe.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Associez la clé à vos propres tables de hachage ou index de base si vous avez besoin d'une recherche d'anagrammes multi-mots ; ce point d'extrémité n'émet que la signature et ne parcourt pas un dictionnaire ni ne renvoie de mots candidats. Envoyez par POST un corps JSON avec un champ obligatoire, text, la chaîne non vide que vous souhaitez transformer en signature. Les alias input, string, value, content et s sont acceptés pour que les scripts réutilisent des noms courants. L'option letters_only vaut true par défaut et peut aussi être envoyée comme lettersOnly, alpha_only ou alphaOnly ; lorsqu'elle est true seules les lettres Unicode restent avant le tri, et lorsqu'elle est false chaque caractère de la chaîne (éventuellement en minuscules) est conservé. L'option case_sensitive vaut false par défaut et peut aussi être envoyée comme caseSensitive ou sensitive ; lorsqu'elle est false le texte est d'abord mis en minuscules pour que les anagrammes à casse mixte partagent une clé, et lorsqu'elle est true la casse est préservée pour que A et a restent distinctes dans la signature triée. L'absence de text, les chaînes vides, les objets et tableaux non chaînes, et les nombres non finis échouent avec invalid_input et un message qui nomme le problème—ces échecs de validation ne sont pas facturés. Un texte au-delà de la limite max_chars déclarée est également rejeté. En cas de succès le corps renvoie le text d'origine et sa length, indique signature comme la clé triée concaténée, signature_length comme la longueur de la clé après filtrage, letters_only et case_sensitive comme booléens résolus, et method égal à anagram_signature. Exemple : listen avec les valeurs par défaut produit signature eilnst et signature_length six.

Où une API de signature d'anagrammes apporte de la valeur

Les backends de jeux de mots et les outils de mots croisés ont besoin d'une clé de groupe stable pour que tout mot qui réordonne les mêmes lettres tombe dans le même seau pour les recherches et les classements. Les plateformes d'enseignement utilisent la signature comme oracle : l'élève soumet un anagramme candidat et le correcteur compare les signatures au lieu de trier sur chaque client. Une validation échouée ne consomme pas le solde. Les pipelines de nettoyage de données qui dédoublonnent des noms de produits ou des libellés flous traitent parfois les sacs de lettres comme un premier passage peu coûteux avant des modèles de similarité plus lourds, et une petite API d'analyse évite de réimplémenter filtres de lettres Unicode et ordre de tri dans chaque langage. Comme l'implémentation est un parse de niveau A pur, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.