Aller au contenu

Passerelle vers l’API

2 outils. Chacun rejoue une route de l’API avec vos droits.

nexus_list_endpoints Inventaire de l’API lecture

Ce que l’API Nexus sait faire, en deux temps : le SOMMAIRE de ses familles avec le nombre de routes de chacune, puis les routes elles-mêmes — rôle, paramètres, corps — par tranches. À lire avant nexus_api_request. Le sommaire est COMPLET : ce qui n’y paraît pas n’existe pas ; ce qui y paraît se lit en filtrant sur le nom de la famille. `suite` nomme l’appel qui donne les routes suivantes.

  • filter texte, facultatif — Un mot du chemin, de la famille ou du résumé — ou un nom de famille du sommaire
  • offset nombre, facultatif — Reprendre à cette position
  • limit nombre, facultatif — Routes par tranche (30 par défaut)
nexus_api_request Appel direct à l’API écrit destructif

Appelle n’importe quelle route de l’API Nexus avec les droits de l’utilisateur — la porte de sortie quand aucun outil dédié ne convient (nexus_list_endpoints donne les chemins et les champs). POST, PUT, PATCH et DELETE modifient des données réelles : annoncer et faire valider avant. Corps imbriqué : préférer « bodyJson », une chaîne transmise telle quelle.

  • method GET | POST | PUT | PATCH | DELETE
  • path texte — ex. /tasks?mine=1, /projects/abc123, /api/v1/library
  • body objet, facultatif — Corps JSON plat
  • bodyJson texte, facultatif — Corps JSON écrit en texte, prioritaire sur body