Aller au contenu

API v3.0

L’API v3.0 constitue une étape importante vers une API unifiée et flexible.

La compatibilité ascendante est garantie entre les versions de l’API. Cette documentation décrit par défaut la dernière version, mais les versions antérieures restent prises en charge. Si vous avez besoin de la documentation d’une version antérieure, contactez le support.

terminal
https://vision.gaard.ai/api

Toutes les requêtes API doivent inclure un token valide dans l’en-tête Authorization avec le schéma Bearer :

Authorization: Bearer <votre-token-api>

Les tokens API sont créés dans l’application Gaard à Settings > Platform > Integrations. Chaque token est rattaché à un tenant et optionnellement à un flow spécifique.

Les requêtes avec un token manquant ou invalide reçoivent une réponse 403 :

{
"success": false,
"error": "no access to current endpoint, make sure you are using correct API key"
}
  • Endpoints : classifier, récupérer les résultats, télécharger la vidéo annotée, supprimer
  • Structure de la réponse : schéma complet de la réponse et description des champs
  • Résultat de classification : type de résultat détaillé, constantes de statut et exemples
  • Webhooks : configurer la livraison des callbacks, inspecter la charge utile et comprendre la latence des webhooks
  • Métadonnées : format optionnel metadata.json pour les soumissions vidéo
  • Risque, labels et scores : comment les scores se traduisent en niveaux de risque et en labels
  • API des labels : lister les labels, publier des labels de retour sur les classifications