Skip to main content

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ête Accept-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ête Accept-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ête Accept-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 code dans 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) :
Puisque 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 :
Utilisez vos bibliothèques de formatage de locale côté client :

Bonnes pratiques

Incluez toujours l’en-tête Accept-Language pour assurer une localisation cohérente. Ne vous fiez pas au comportement par défaut.
Stockez la préférence de langue de l’utilisateur dans votre application et incluez-la automatiquement dans toutes les requêtes API.
Sachez que les locales non supportées se replieront sur l’anglais. Concevez votre interface pour gérer cela gracieusement.
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
Nous ajoutons regulierement de nouvelles langues en fonction de la demande des clients.

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