Aperçu du SDK JavaScript

​

SDK JavaScript / TypeScript

​

Fonctionnalités

• Définitions de types TypeScript complètes pour chaque requête et réponse
• Tentatives automatiques avec back-off exponentiel sur les erreurs transitoires
• Hiérarchie d’erreurs structurée avec des fonctions de type guard
• Support multi-tenant via le contexte businessId
• Réponses localisées (en-CA, fr-CA)
• Builds double format ESM et CommonJS
• Téléchargement de fichiers via FormData et flux de téléchargement présigné S3

​

Démarrage rapide

import { SmartbillsClient } from '@smartbills/sdk';

const client = new SmartbillsClient({
  accessToken: 'VOTRE_CLE_API',
  businessId: 123,
  locale: 'fr-CA',
});

// Lister les dépenses récentes
const { data: expenses, pagination } = await client.expenses.listBusiness({
  limit: 25,
  page: 1,
});
console.log(`${pagination.count} dépenses trouvées`);

// Créer un rapport de dépenses
const report = await client.expenseReports.create({
  name: 'Dépenses de voyage T1',
});

// Télécharger un reçu
const formData = new FormData();
formData.append('files', fichierRecu);
const uploaded = await client.expenses.uploadBusiness(formData);

​

Services disponibles

​

Prérequis

• Node.js 18 ou plus récent
• TypeScript 5.0 ou plus récent (optionnel mais recommandé)

​

Prochaines étapes

• Installation, installer le package et configurer votre environnement
• Authentification, configurer les identifiants et le contexte multi-tenant
• Dépenses, référence complète du service de dépenses
• Gestion des erreurs, comprendre la hiérarchie des erreurs