Premier mot du texte

La même fonction déterministe alimente l'outil gratuit du navigateur et l'API prépayée, ainsi un aperçu CMS, un assistant de slugs et un test unitaire ancrent le même JSON pour la même entrée. Les chaînes sans mots — vides, espaces seuls ou ponctuation seule — échouent avec invalid_input et ne sont pas facturées. Les appels API réussis coûtent $0.002 par élément.

Contrat d'entrée, champs de réponse et texte vide ou sans mots

Une chaîne vide, uniquement des espaces ou uniquement de la ponctuation échoue aussi, car aucun mot portant des lettres ou des chiffres n'a été trouvé : le message indique que text doit contenir au moins un mot et que espaces et ponctuation seuls ne suffisent pas. Remainder est omis lorsque l'entrée est un seul mot, jamais envoyé comme null. Envoyez en POST un corps JSON avec le champ chaîne obligatoire text fixé au passage que vous souhaitez analyser. Les alias input, value, s, content et body sont acceptés afin que générateurs de formulaires et anciens clients publient sous des noms familiers. La valeur doit être une chaîne ; objets, tableaux, booléens et nombres échouent avec invalid_input en nommant le problème. Les charges plus longues que le plafond de caractères documenté échouent de la même façon afin qu'une seule requête ne monopolise pas la mémoire du Worker. Ces échecs de validation ne sont pas facturés sur l'API prépayée. En cas de succès, la réponse signale first_word comme le jeton d'ouverture nettoyé, length comme son nombre de caractères, original comme écho de l'entrée pour les tableaux d'interface, start_index et end_index comme les décalages de ce jeton dans original, remainder comme la chaîne restante après le mot avec les espaces extérieurs retirés, et method toujours à first_word pour que les clients se ramifient sans flairer les formes. Exemple : Hello, world — this is a preview. donne first_word Hello, length cinq, start_index zéro et un remainder qui commence par une virgule et le reste de la phrase. Une ligne rembourrée de deux espaces, trois points, well-known et une phrase donne first_word well-known parce que le trait d'union est interne et que la ponctuation initiale ne l'est pas.

Aperçus, slugs, pipelines d'analyse, tarif et limites pratiques

Appelez l'outil gratuit dans le navigateur pour obtenir le premier mot lorsque vous avez besoin d'un jeton d'ouverture propre pour l'aperçu d'une carte, la racine d'un nom de fichier, un badge de discussion ou un analyseur de commandes qui doit ignorer les guillemets enveloppants. Les pipelines éditoriaux utilisent le même appel pour transformer un titre en étiquette courte sans traîner la virgule ou le tiret cadratin dans le badge. Associez ce point de terminaison à un outil de slug ou de mot le plus long lorsque l'étape suivante est une URL ou un contrôle typographique, mais conservez get-first-word comme page dédiée afin de ne pas mêler l'intention du jeton d'ouverture à la conversion de slugs de toute la chaîne, aux décomptes de mots ou à l'extraction de mots-clés. N'attendez pas de racinisation, de suppression de mots vides ni de détection de langue : ce sont d'autres recherches et d'autres contrats. Les développeurs branchent l'API prépayée KIT lorsqu'un CMS, un client mobile ou un lot a besoin du même contrat sous solde à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde après le rejet du moteur. Un flux typique colle un titre, lit first_word et le passe en minuscules localement si un assistant de slugs a besoin d'une graine.