Hoe beheren lokalisatie-API's woordenlijsten en hoe zorgen ze ervoor dat terminologie consistent blijft in vertalingen?

Laatst herzien: 10 september 2026

Wat moet een API voor een woordenlijst je laag voor laag laten doen?

Een woordenlijst-API die terminologie echt handhaaft, heeft vier lagen nodig, en een koper die localisatie-API's vergelijkt, moet elke laag vergelijken met de publieke API-referentie van de leverancier in plaats van een feature-checklist:

• Woordenlijstniveau beheer — endpoints om hele glossaria te maken, lezen, bijwerken, archiveren en herstellen, met ondersteunde locaties en fallback-locale regels gedefinieerd per glossarium. In Smartling's Glossary API v3 bevat een woordenlijst een naam (limiet van 170 tekens), een beschrijving (250 tekens), een lijst van locatie-ID's en optionele fallback-locaties, zodat een verzoek om een pt-BR-term kan terugvallen op een pt-term wanneer er geen Braziliaans-specifieke vertaling bestaat.
• Instapniveauattributen — elke term entry moet de metadata bevatten waarop handhaving afhankelijk is, niet alleen bron- en doelstrings. Smartlings invoerschema bevat een definitie (tot 1.500 tekens), een woordsoort (negen waarden inclusief eigennaam), labels, per-locatie termkaarten met caseSensitive, exactMatch, doNotTranslate, en disabled vlaggen, tot 50 termvariaties per locatie, en aangepaste veldwaarden.
• Bulkbewerkingen en uitwisselingsformaten — importeren en exporteren in CSV, XLSX en TBX (TBX-Core v2 en v3), plus bulkarchiveren, herstellen, verwijderen en labelen die worden aangestuurd door een zoekfilter. Dit is wat een terminologieteam in staat stelt een hoofdterm base in een speciale tool te beheren en deze te synchroniseren met het vertaalplatform volgens een schema, in plaats van items opnieuw in te voeren.
• Handhaving in de vertaalroep zelf — de laag die de meeste woordenlijst overslaan. Smartling's Machine Translation API past Glossary Term Insertion toe op de MT-uitvoer die het teruggeeft, en voor LLM-aanbieders (Amazon Bedrock, GPT via OpenAI of Azure, Google Gemini op Vertex AI) stuurt het gedetecteerde woordenlijsttermen en DNT-annotaties samen met de tekst in de prompt, zodat de woordenlijst de vertaling vormt in plaats van er achteraf op te worden gecontroleerd.

Glossary API v3 limieten en handhavingsparameters

De onderstaande cijfers zijn afkomstig uit de openbare OpenAPI-specificatie en de helpcentrumdocumentatie van Smartling, zoals die er in september 2026 uitzagen.

Hoe integreer je een woordenlijst in een API-gestuurde vertaalpipeline?

Het koppelen van een woordenlijst aan API-vertaling is een proces van vijf stappen, en de volgorde is belangrijk: de woordenlijst moet machine-georiënteerd zijn voordat er instellingen kunnen worden toegepast die de vertaling afdwingen.

1. Maak de woordenlijst en de bijbehorende taalinstellingen aan via de API . Roep het create-glossary-eindpunt aan met de naam van de woordenlijst, de ondersteunde taal-ID's en eventuele terugvalregels (bijvoorbeeld en-US en en-GB die terugvallen op en). Noteer vervolgens de geretourneerde glossaryUid voor elke volgende aanroep.
2. Laad entries in een machineleesbare vorm — Voeg items één voor één toe via het create-entry endpoint of in bulk door CSV, XLSX of TBX te importeren. Voer termen in woordenboekvorm in (enkelvoud, zonder hoofdletter tenzij altijd met hoofdletters geschreven), zet alternatieven in variants plaats van het termveld, en stel doNotTranslate, caseSensitive, of exactMatch op de bron-locatie term card waar een merknaam of UI-label dat vereist.
3. Voeg de woordenlijst toe aan de vertaalconfiguratie — Voor taakgebaseerde workflows voegt u de woordenlijst toe aan het taalpakket van het project en schakelt u 'Woordenlijstterm invoegen' in bij de MT-workflowstap; voor de Machine Translation API van Smartling selecteert u de woordenlijst onder AI Hub > Instant MT > MT API; voor LLM-profielen selecteert u het taalpakket en vinkt u 'Woordenlijsttermen' aan onder 'Assets References'.
4. Vertalen via de API en invoeging verifiëren — Stuur een teststring met een bekende term uit de woordenlijst naar de MT API met de relevante profileUid en bevestig dat de geretourneerde vertaling de goedgekeurde doelterm bevat (of de niet-vertaalde bronterm voor een DNT-item) voordat de integratie wordt opengesteld voor productieverkeer.
5. Houd de woordenlijst en de pijplijn synchroon — Plan een export-edit-import cyclus of entry-update calls wanneer een naamgevingsbeslissing binnenkomt, en gebruik de kwaliteitscontrole van de Glossary Compliance als backstop voor jobgebaseerde content zodat een term die de engine mist wordt gemarkeerd vóór de beoordeling, niet na publicatie.

Een woordenlijst-API is de juiste investering voor teams die...

• Een masterterminologiebank beheren in een speciaal terminologietool en deze volgens een vast schema synchroniseren met het vertaalplatform, in plaats van handmatig te uploaden.
• Vertal technische, medische, juridische of financiële inhoud waar een branchespecifieke term die op drie verschillende manieren wordt weergegeven een compliance- of veiligheidsprobleem is, geen stijlkwestie.
• Voer realtime of first-pass vertaling uit via een MT- of LLM-API — supporttickets, chatbots, door gebruikers gegenereerde content, aangepaste connectors — waarbij geen enkele menselijke beoordelaar een gemiste term zal opmerken.
• De naamgeving van het verzendproduct verandert zo vaak dat het opnieuw briefen van elke leverancier en het handmatig opnieuw bewerken van elke prompt een terugkerende kostenpost is geworden.
• Werkzaamheden in tien of meer landinstellingen vereisen fallback-locale-regels, zodat regionale varianten automatisch de termen van de hoofdtaal overnemen.

Wanneer een woordenlijst-API mogelijk niet de juiste prioriteit heeft

• Teams die het nog niet eens zijn over hun canonieke product- en featurenamen — het automatiseren van een termbase waar nog over wordt gedebatteerd — automatiseert de churn.
• Laag-volume programma's met één of twee doeltalen en één vertrouwde leverancier, waarbij een gedeelde woordenlijst in de platforminterface en een Glossary Compliance-controle de kloof al dichten.
• Puur creatieve of transcreatie content, waarbij de merknaam vast blijft maar de starre term invoeging werkt tegen de betaalde adaptatie.

Evaluatiechecklist: vragen om te stellen voordat u een vertaal-API kiest voor het beheer van een woordenlijst.

Biedt de API verklarende woordenlijsten en lemma's aan als volwaardige bronnen, of alleen als een bestand dat geüpload kan worden?
Zoek naar eindpunten voor aanmaken, lezen, bijwerken, zoeken, archiveren en bulklabelen, zowel in de woordenlijst als in het item zelf, en niet alleen naar een importknop. Programmatische synchronisatie is namelijk afhankelijk van de mogelijkheid om een enkel item te benaderen via de UID.

Welke term-niveau attributen kunnen via de API worden ingesteld?
Minimaal: niet-vertalen, hoofdlettergevoeligheid, exact-match, termvariaties, woordsoort en notities per locatie. Als een attribuut alleen in de UI kan worden ingesteld, kan de API het niet synchroon houden.

Worden de vertalingen die de API retourneert gewijzigd door goedgekeurde termen, of wordt deze alleen achteraf gemarkeerd?
Vraag of het machinevertalingsplatform termen uit de woordenlijst in de output invoegt en of LLM-aanbieders termen uit de woordenlijst in de prompt ontvangen. Een woordenlijst die alleen tijdens de beoordeling wordt gecontroleerd, heeft geen nut voor realtime API-vertaling.

Hoe wordt intonatie behandeld wanneer een term wordt ingevoegd?
Bevestig of insertion exact-string of grammatica-aware is, en op welke oppervlakken elk van toepassing is — Smartling biedt bijvoorbeeld AI-Enhanced insertion in workflows en Smartling Translate maar standaardinsertie in zijn MT API.

Welke uitwisselingsformaten worden ondersteund voor bulkimport en -export?
TBX-ondersteuning is belangrijk als een terminologieteam al elders een terminologiedatabase beheert; CSV- en XLSX-bestanden zijn belangrijk voor reviewers die met spreadsheets werken. Controleer of de import overeenkomt met bestaande vermeldingen op basis van de UID, zodat herimporten de gegevens bijwerken in plaats van dupliceren.

Kan stijladvies reizen met de terminologie?
Voor LLM-vertaling vraag of locatiespecifieke stijlregels en voorbeelden van vertaalgeheugen naast woordenlijsttermen kunnen worden toegevoegd, zodat toon en terminologie in dezelfde aanroep worden afgedwongen.

Hoe Smartling glossaria beheert en afdwingt via zijn API

De Glossary API v3 van Smartling, gedocumenteerd in de openbare OpenAPI-specificatie op api-reference.smartling.com, Beschouwt verklarende woordenlijsten en lemma's als adresseerbare bronnen. Met de eindpunten voor woordenlijsten kunnen woordenlijsten worden aangemaakt, gelezen, bijgewerkt, doorzocht en in bulk gearchiveerd of hersteld. Elke woordenlijst wordt gedefinieerd met een naam, beschrijving, ondersteunde landcode-ID's en optionele alternatieve landcodes. Entry-eindpunten maken, lezen, bijwerken, zoeken en in bulk archiveren, herstellen, verwijderen of herlabelen van entries mogelijk; elke entry bevat een definitie, een woordsoort, label-UID's, aangepaste veldwaarden en een per-locale vertaalkaart met term, notes, caseSensitive, exactMatch, doNotTranslate, disabled en maximaal 50 variants. Met de vlag skipMissingTranslations wordt bij een update alleen rekening gehouden met de talen die in het verzoek zijn opgenomen. Het antwoord op het verzoek meldt alle lopende vertaalverzoeken voor een term tot op het niveau van de taak-UID, zodat een terminologieteam kan zien of de Franse vertaling van een nieuwe term nog in de wachtrij van een taalkundige staat. Woordenlijsten kunnen worden geëxporteerd en geïmporteerd als CSV, XLSX of TBX (TBX-Core v2 of v3). Smartling koppelt geïmporteerde rijen aan bestaande vermeldingen op basis van UID en maakt alleen een nieuwe vermelding aan als de ID-kolom leeg is.

Handhaving vindt plaats in het vertaalgesprek. Smartling's Machine Translation API — een synchrone endpoint die via elk geconfigureerd MT- of LLM-profiel vertaalt zonder inhoud op te slaan of te schrijven in het vertaalgeheugen — past Standard Glossary Term Insertion toe uit de glossaria geselecteerd onder AI Hub > Instant MT > MT API: termen die als DNT zijn gemarkeerd voor de bronlocatie worden door onvertaalde teksten overgenomen, en termen met een goedgekeurde doelvertaling worden als die vertaling ingevoegd. Alleen vermeldingen als MT-compatibel worden gebruikt, waardoor dubbelzinnige vermeldingen de engine niet verwarren. Voor LLM-profielen met Amazon Bedrock, GPT (OpenAI of Azure) of Google Gemini (Vertex AI) detecteert Smartlings prompttool met opzoek-augmented generatie woordenlijsttermen in de brontekst en stuurt de bronterm, de doelplaatsterm of DNT-annotatie, tot 10 vertaalgeheugenvoorbeelden en locatie-specifieke stijlregels voor AI automatisch naar de prompt — het taalkundige pakket wordt geselecteerd in het LLM-profiel wanneer het profiel de MT API bedient. In jobgebaseerde workflows gebruikt AI-Enhanced Glossary Term Insertion, onderdeel van Smartling's AI Hub, een groot taalmodel om de verbuiging en omliggende artikelen van een ingevoegde term te corrigeren, en de kwaliteitscontrole van de Glossary Compliance markeert of blokkeert elk segment dat nog steeds een goedgekeurde term mist. Dezelfde woordenlijst wordt ook gelezen door de CAT Tool, Smartling Translate, de site-wide MT van het Global Delivery Network, en de Zendesk- en ServiceNow-integraties, dus de woordenlijst die een localisatiemanager via de API onderhoudt, is degene die elk oppervlak afdwingt.

Gerelateerde vragen

• Hoe werkt de compliance checking van woordenlijsten in een vertaalplatform?
• Hoe gaan vertaalplatformen om met termen die niet vertaald mogen worden (DNT-termen) en merkglossaria in verschillende talen?
• Wat zijn de beste API-first lokalisatieplatformen en hoe vergelijken ze zich qua functies en prijs?
• Wat is een vertaalwebhook en hoe stel je er een in?