Documentation développeursAPI v1

Premiers pas

Développez sur votre espace de travail.

Connectez vos outils à l’API JSON de Squario. Découvrez le schéma, lisez et modifiez les données avec vos permissions de l’application.

Une API, votre espace de travail

L’API REST utilise HTTPS et JSON. Une clé appartient à un membre et à un espace de travail. Votre URL de base se termine déjà par /functions/v1/public-api/v1 ; copiez-la depuis Paramètres → API et ajoutez le chemin de l’endpoint utilisé dans ces guides. La documentation est accessible sur /docs, au sein du site Squario.

  • Authentifiez-vous avec l’en-tête Authorization et une valeur Bearer <API_KEY>.
  • Une liste expose data et ses informations de pagination dans meta.
  • La lecture ou l’écriture d’une fiche renvoie un objet data.
  • Utilisez X-Request-Id pour retrouver une requête.

Les permissions suivent la clé

Chaque opération agit en tant que membre ayant créé la clé. L’appartenance à l’espace de travail, les permissions sur les ressources et les restrictions par champ sont vérifiées côté serveur. L’accès en lecture ou écriture, les ressources autorisées et les IP autorisées d’une clé peuvent réduire cet accès. Ils ne peuvent pas l’étendre.

API REST ou MCP

Les deux connexions utilisent le même noyau d’actions sur les ressources. Choisissez REST pour une intégration que vous pilotez, ou MCP pour connecter un client IA avec le consentement du membre.

API REST ou MCP
ConnexionIdentifiantUsage adaptéConsommation
API RESTClé API de membreIntégrations serveur, imports et synchronisationQuota mensuel de requêtes API
MCPAutorisation OAuth 2.1Clients et assistants IA distantsCrédits IA de l’espace de travail

Commencez par une lecture

Appelez /me, découvrez les ressources couvertes par votre clé, puis décrivez celle dont vous avez besoin. Son schéma en ligne inclut les champs personnalisés accessibles de votre espace de travail. La référence décrit chaque route et ses schémas de requête et de réponse.