Guide de développement Canopsis¶
Vous trouverez ici toute la documentation nécessaire au développement autour de Canopsis.
Documentation des API¶
Canopsis repose sur un ensemble d'API REST (voir une définition), pour son fonctionnement interne et pour son interfaçage avec d'autres programmes.
Ces API ont connu 4 versions différentes. L'APIv4 est la version actuelle.
APIv4¶
La documentation des nouvelles APIv4 est disponible par le biais de Swagger.
Ces nouvelles API suivent l'OpenAPI Specification 2.0.
Anciennes API¶
Les anciennes API v1 ou v2 ne sont plus utilisées par les dernières versions de Canopsis, et n'ont donc plus lieu d'être utilisées ou documentées.
URL de l'API¶
L'API Canopsis peut être interrogée sur deux URL différentes :
http://<canopsis>/backend/api/v4/: via le reverse-proxy Nginx (avec les en-têtes CORS)http://<canopsis>:8082/api/v4/: moteurcanopsis-apidirectement (sans les en-têtes CORS)
Remplacer
<canopsis>par l'adresse IP ou le nom de domaine du Canopsis déployé.
Si l'API est interrogée via un navigateur (Firefox, Chrome, Safari, etc) ou un framework emulant un navigateur (Angular, Electron, etc) et pour lesquels en-têtes CORS sont nécessaires, alors il faut utiliser l'URL du reverse-proxy Nginx.
L'usage de l'URL du moteur canopsis-api est possible pour des requêtes dites "classiques", par exemple via des scripts, via l'outil curl ou encore via des webhooks de solutions externes.