API
Référence de l'API REST v1 pour les développeurs.
Prise en main
- Introduction à l'APIBase URL, authentification par clé Bearer et premier appel à l'API REST v1 de Naskel.
- Scopes et permissionsLes dix scopes disponibles, le cas particulier des entreprises, et l'erreur renvoyée quand un scope manque.
- Limites de débit60 requêtes par minute et par espace, les en-têtes à surveiller, et la réponse en cas de dépassement.
- Pagination et format des réponsesParamètres limit et offset, enveloppe des listes et des objets, et format des dates.
- Codes d'erreurLe format des erreurs de l'API et la liste des codes possibles, du 400 au 500.
Ressources
- FacturesLister, lire, créer, modifier et supprimer des factures via l'API. Champs renvoyés, corps de création et exemples.
- EntreprisesLister, lire, créer et modifier des entreprises via l'API. Ces endpoints réutilisent les scopes des contacts.
- DevisLister, lire, créer, modifier et supprimer des devis via l'API. Champs renvoyés, corps de création et passage au statut envoyé.
- ContactsLister, lire, créer, modifier et supprimer des contacts via l'API. Champs renvoyés et corps de création.
- OpportunitésLister, lire, créer, modifier et supprimer des opportunités via l'API. Champs renvoyés, statuts et corps de création.
- ProduitsLister et lire vos produits, leur état de stock, et ajuster un stock sur inventaire physique via l'API.
- Mouvements de stockEnregistrer des entrées et sorties de stock par lot via l'API, avec traitement partiel et idempotence.