Aller au contenu
BizQuery

API — Démarrage rapide

Tout ce que vous pouvez faire dans l’application, vous pouvez le faire via une simple API HTTP. Tous les points d’accès sont sous /v1 et renvoient du JSON.

1. Obtenir une clé API

Dans l’application, ouvrez Compte → Clés API et créez-en une (voir Équipes et accès). Copiez le secret immédiatement — il n’est affiché qu’une fois.

2. Trouver votre URL de base

  • Hébergé : https://app.bizquery.dev
  • Auto-hébergé : votre propre hôte BizQuery.

L’API se trouve alors à <base>/v1.

3. S’authentifier

Envoyez la clé comme jeton Bearer à chaque requête :

Fenêtre de terminal
export BQP_BASE="https://app.bizquery.dev"
export BQP_KEY="votre-clé-api"


curl "$BQP_BASE/v1/personas" \
  -H "Authorization: Bearer $BQP_KEY"

Un 200 avec un tableau JSON signifie que vous êtes connecté. Un 401 signifie que la clé est absente ou erronée.

Explorer la référence complète

Parcourez ici la référence d’API complète et interactive : Référence API — chaque point d’accès avec ses formes exactes de requête et de réponse, générée à partir de la spécification OpenAPI.

Votre propre hôte BizQuery propose aussi une console Swagger live et authentifiée à /docs pour essayer des appels sur vos propres données.