Gratis setup bij jaarabonnementen
Meld je vandaag aan!
Vertalingen
API-referentie: Vertalingen endpoints
Huidige endpoints
Tekst vertalen
Deze endpoints zijn nutscalls op klantniveau. Ze beheren geen opgeslagen websitevertalingen of vertaalde kanaal-UI labels. Chatspecifieke vertalingen van de UI/berichten per kanaal worden beheerd door de Channels API via /api/ChannelTranslations en /api/Channels/{channelToken}/translations-by-token/{lang}.
POST/api/Translations/translate– Bearer JWT
Vertaal één platte tekstwaarde naar de gewenste doeltaal. Bodyvelden zijnsourceTextentargetLang. De huidige service gebruiktgpt-4o-minien geeft de vertaalde tekst terug als een gewone string.GET/api/Translations/detect-language-ai– Bearer JWT
Leidt een waarschijnlijke primaire taal af op basis van de queryparameterscountry,stateencity.countryis verplicht;stateencityzijn optionele context. De huidige service vraagt om een ISO 639-3 taalcodering.
Vertaalrequestbody
POST /api/Translations/translate
Authorization: Bearer {token}
Content-Type: application/json
{
"sourceText": "Thank you for your message.",
"targetLang": "nld"
}Requestvelden
TranslateRequest body
sourceText
Verplicht veld voor een string. Lege of alleen spatie-invoer resulteert in 400 Bad Request.targetLang
Verplichte taalcode die aan de vertaalmachine wordt doorgegeven. Gebruik bij voorkeur stabiele ISO-codes zoalsnld,fra,deuofeng.
Query voor taaldetectie
country
Verplichte landnaam of -code. Een ontbrekende of alleen-spatie waarde resulteert in 400 Bad Request.state,city
Optionele context van staat/provincie en stad ter verbetering van de taalinschatting.
Vertaalantwoord
Bedankt voor uw bericht.Antwoord en fouten
Antwoordformaat
POST /api/Translations/translate
Geeft200 OKterug met de vertaalde tekst als platte string, geen JSON-object.GET /api/Translations/detect-language-ai
Geeft200 OKterug met een taalcode-string zoalsnld,fraofeng.
Toegang en fouten
Bearer JWT
Beveiligde AnswerPal API-endpoints gebruiken JWT Bearer-authenticatie. Er is geen publieke anonieme vertaalroute.400
Wordt teruggegeven wanneer verplichte input ontbreekt of de geauthenticeerde klant geen OpenAI API-sleutel heeft geconfigureerd.404
Wordt door de vertaling teruggegeven wanneer het klantenrecord niet gevonden kan worden.500
Wordt teruggegeven wanneer de AI-vertaal- of taaldetectie-call onverwacht faalt.
POST /api/Translations/translate
Authorization: Bearer {token}
Content-Type: application/json
{
"sourceText": "Thank you for your message.",
"targetLang": "nld"
}Bedankt voor uw bericht.GET /api/Translations/detect-language-ai?country=Belgium&state=Flanders&city=Antwerp
Authorization: Bearer {token}nldDetecteer taal
GET /api/Translations/detect-language-ai gebruikt locatiecontext om de meest waarschijnlijke primaire taal af te leiden. Het endpoint vereist country; state en city geven extra context.
Detectie queryparameters
TranslateRequest body
sourceText
Verplicht veld voor een string. Lege of alleen spatie-invoer resulteert in 400 Bad Request.targetLang
Verplichte taalcode die aan de vertaalmachine wordt doorgegeven. Gebruik bij voorkeur stabiele ISO-codes zoalsnld,fra,deuofeng.
Query voor taaldetectie
country
Verplichte landnaam of -code. Een ontbrekende of alleen-spatie waarde resulteert in 400 Bad Request.state,city
Optionele context van staat/provincie en stad ter verbetering van de taalinschatting.
Detectieantwoord
Request
GET /api/Translations/detect-language-ai?country=Belgium&state=Flanders&city=Antwerp
Authorization: Bearer {token}Response
nldVelden en gedrag
TranslateRequest
TranslateRequest body
sourceText
Verplicht veld voor een string. Lege of alleen spatie-invoer resulteert in 400 Bad Request.targetLang
Verplichte taalcode die aan de vertaalmachine wordt doorgegeven. Gebruik bij voorkeur stabiele ISO-codes zoalsnld,fra,deuofeng.
Query voor taaldetectie
country
Verplichte landnaam of -code. Een ontbrekende of alleen-spatie waarde resulteert in 400 Bad Request.state,city
Optionele context van staat/provincie en stad ter verbetering van de taalinschatting.
String-antwoorden
Antwoordformaat
POST /api/Translations/translate
Geeft200 OKterug met de vertaalde tekst als platte string, geen JSON-object.GET /api/Translations/detect-language-ai
Geeft200 OKterug met een taalcode-string zoalsnld,fraofeng.
Toegang en fouten
Bearer JWT
Beveiligde AnswerPal API-endpoints gebruiken JWT Bearer-authenticatie. Er is geen publieke anonieme vertaalroute.400
Wordt teruggegeven wanneer verplichte input ontbreekt of de geauthenticeerde klant geen OpenAI API-sleutel heeft geconfigureerd.404
Wordt door de vertaling teruggegeven wanneer het klantenrecord niet gevonden kan worden.500
Wordt teruggegeven wanneer de AI-vertaal- of taaldetectie-call onverwacht faalt.
Voor opgeslagen UI/berichtvertalingen per kanaal zoals chat-titels, begroetingen, knoptekst en escalatieprompts, zie de Channels API-referentie. De huidige routes voor kanaalvertalingen zijn /api/ChannelTranslations en publieke token-gebaseerde opvraging gebruikt /api/Channels/{channelToken}/translations-by-token/{lang}.
Neen. De Vertalingen-API vertaalt een ad-hoc platte tekstwaarde of detecteert een waarschijnlijke taal op basis van locatiecontext. Vertalingen van opgeslagen chat-UI/berichten worden beheerd via de Channels API en /api/ChannelTranslations.
Er is momenteel geen publieke controllerroute die HTML-vertaling aanbiedt. Gebruik POST /api/Translations/translate voor platte tekst en behandel eventuele HTML-conversie in uw integratie.
Het endpoint gebruikt het geauthenticeerde klantrecord en de geconfigureerde OpenAI API-sleutel van die klant. Indien er geen sleutel is geconfigureerd, geeft het endpoint 400 terug.
Inhoudstafel
AnswerPal: AI-gedreven oplossingen voor klantenservice die je ondersteuning en communicatie moeiteloos versterken.
Snelle links
Contact
Voor ondersteunings-, commerciële en partnervragen kunt u mailen naar [email protected]
AnswerPal
Bisschoppenhoflaan 380
2100 Antwerpen
België
+32.36416685
BE 0862.692.858