API Robaws
Nous distinguons deux types d'intégrations : une intégration sur mesure et une intégration marketplace.
- Une intégration sur mesure est construite pour un client spécifique afin de soutenir un processus propre à ce client.
- Une intégration marketplace est une intégration standard mise à la disposition de tous les clients Robaws dans la marketplace des intégrations Robaws.
La différence entre les deux réside dans la méthode d'authentification. Les exigences pour une intégration marketplace sont légèrement plus strictes.
Je souhaite construire une intégration sur mesure
Pour les intégrations sur mesure, l'authentification HTTP Basic est la méthode d'authentification recommandée. Nous vous recommandons de créer un utilisateur distinct dans l'environnement Robaws du client. Si vous cochez la case 'API only', l'utilisateur est gratuit. Il est considéré comme une bonne pratique de créer un rôle distinct pour cet utilisateur, en n'accordant l'accès qu'aux modules dont l'intégration a besoin.
Vous devez ensuite créer une clé d'accès pour cet utilisateur. Vous pouvez le faire sur la page de profil. Cette clé d'accès et le secret sont utilisés comme nom d'utilisateur et mot de passe pour l'authentification basique.
Pour commencer
- Des tenants de test peuvent être fournis gratuitement pendant 14 jours. Si nécessaire, cette période peut être prolongée.
- Les questions relatives à une nouvelle intégration peuvent être soumises via ce formulaire.
Je souhaite construire une intégration marketplace
Pour les intégrations marketplace, le flux OAuth2 Authorization Code est la méthode d'authentification requise. Les exigences sont :
- Vous ne rafraîchissez pas les access tokens tant qu'ils ne sont pas (presque) expirés.
- Vous construisez d'abord l'intégration sur un tenant de test Robaws.
- Pour que votre intégration devienne disponible en production (dans la marketplace Robaws), une vidéo de démonstration sera requise dans laquelle vous démontrez l'intégration.
- Vous devrez nous fournir une URL vers la page où le client peut lancer le flux OAuth2 de votre côté.
- Le polling est déconseillé ! Si votre intégration doit être informée d'un changement qui s'est produit, vous devez utiliser les webhooks.
Pour commencer
- Vous pouvez obtenir un environnement de test gratuit pendant 14 jours. Si nécessaire, cette période peut être prolongée d'un commun accord. Vous trouverez plus d'informations sur l'obtention d'un compte de test via ce formulaire.
- Pour une intégration marketplace, vous aurez besoin d'un client ID & client secret OAuth2. Contactez-nous pour obtenir les identifiants via ce formulaire.
Documentation de référence
https://app.robaws.com/public/api-docs/robaws
Votre intégration API doit tenir compte des en-têtes de réponse de rate limiting de Robaws. Les erreurs HTTP 429 seront surveillées. Si elles se produisent trop souvent, l'équipe Robaws interviendra pour bloquer temporairement l'intégration jusqu'à ce que vous fournissiez une solution. Plus de détails sur le rate limiting sont disponibles dans la documentation de référence.
Mises à jour
Voir le changelog API
Sujets spécifiques
Webhooks
Idempotence des requêtes
Rate limiting de l'API
Filtrage, pagination et tri de l'API
Mise à jour des informations (PUT vs PATCH)
Envoi de fichiers
Calculer via l'API
Exemples de cas d'usage
- Créer un bon de travail
- Synchroniser les données d'articles avec votre propre base de données
- Créer un client/lead à partir d'un formulaire de site web
- [Comment récupérer les factures pour les importer dans un logiciel de c
Mis à jour le : 05/07/2026
Merci !