Aperçu
L’API Smartbills prend en charge plusieurs langues et locales, vous permettant de recevoir des réponses localisées pour vos utilisateurs. Utilisez l’en-têteAccept-Language pour spécifiér la locale souhaitee pour chaque requête.
Locales supportées
Locale par défaut : Si aucun en-tête
Accept-Language n’est fourni, l’API utilisé par défaut en-CA.Définir la locale
Incluez l’en-têteAccept-Language dans vos requêtes API pour recevoir des réponses localisées :
Exemples de code
Champs de réponse localises
Lorsque vous spécifiéz une locale, les éléments suivants sont localises dans les réponses API :Messages d’erreur
Les messages d’erreur sont retournés dans la langue demandée :Noms de catégories
Les catégories de dépenses sont automatiquement localisées :Etiquettes de statut
Les etiquettes de statut sont localisées selon l’en-têteAccept-Language :
Messages de validation
Les messages de validation au niveau des champs sont retournés dans la langue demandée :Champs NON localises
Les champs suivants sont toujours retournés tels quels, quelle que soit la locale :- Identifiants :
id,code,status(valeurs lisibles par machine) - Montants :
amount,totalAmount(valeurs numériques) - Dates :
date,createdAt,updatedAt(format ISO 8601) - Devises :
currency(codes ISO 4217) - Données saisies par l’utilisateur :
merchant,notes,description(stockées telles que saisies) - Codes d’erreur : champ
codedans les réponses d’erreur (lisible par machine)
Comportement de repli
Si une traduction n’est pas disponible pour une locale spécifique, l’API se replie sur l’anglais (en-CA) :
de-DE n’est actuellement pas supporte, les réponses se replieront sur l’anglais.
Formatage des devises et des nombres
L’API retourné des valeurs numériques brutes. Le formatage spécifique à la locale devrait être géré côté client :Bonnes pratiques
Toujours spécifiér Accept-Language
Toujours spécifiér Accept-Language
Incluez toujours l’en-tête
Accept-Language pour assurer une localisation cohérente. Ne vous fiez pas au comportement par défaut.Stocker les préférences utilisateur
Stocker les préférences utilisateur
Stockez la préférence de langue de l’utilisateur dans votre application et incluez-la automatiquement dans toutes les requêtes API.
Gérer les traductions manquantes
Gérer les traductions manquantes
Sachez que les locales non supportées se replieront sur l’anglais. Concevez votre interface pour gérer cela gracieusement.
Formater les nombres et dates côté client
Formater les nombres et dates côté client
L’API retourné des valeurs brutes pour les montants et les dates. Utilisez des bibliothèques de formatage sensibles à la locale côté client pour l’affichage.
Demander de nouvelles langues
Si vous avez besoin du support pour des langues supplémentaires, contactez-nous à [email protected] avec :- La langue et la locale dont vous avez besoin
- Votre cas d’utilisation
- Le volume de requêtes prévu
Ressources connexes
Introduction à l'API
Aperçu de l’API et en-têtes
Gestion des erreurs
Messages d’erreur localises
Authentification
Authentification et en-têtes
Environnements
Bac à sable et production