VisioFormation · APIConnecter vos outils, conserver le contrôle

Authentifier et tester une connexion API

Les deux en-têtes sont obligatoires ensemble, à chaque appel. Il n’y a ni Basic Auth, ni signature HMAC, ni authentification par cookie, URL ou corps JSON.

X-VF-Token-1: <TOKEN_1>
X-VF-Token-2: <TOKEN_2>
Content-Type: application/json
Accept: application/json
Idempotency-Key: evenement-source-001

Idempotency-Key est obligatoire pour les huit POST. Elle contient 1 à 128 caractères parmi les lettres ASCII, chiffres, ., _, : et -. Aucun corps n’est accepté pour GET /auth/check. HTTPS est obligatoire ; ne désactivez pas la vérification du certificat TLS.

Le corps doit être un objet JSON UTF-8, sans propriétés en double. Les champs inconnus sont refusés, y compris dans les objets imbriqués. Aucun upload, champ personnalisé, propriété school_id, identifiant administrateur, mot de passe ou jeton de lien public n’est accepté. Les formulaires, XML, multipart et corps compressés ne sont pas pris en charge. Les restrictions IP sont facultatives ; une liste vide les désactive.

Les identifiants sont des chaînes décimales positives : "123", jamais 123. Les montants et durées sont des chaînes de 0 à 99999999.99 avec au plus deux décimales ; "0" et "0.00" sont valides et normalisés à "0.00". Un champ absent, une valeur null et un zéro ne sont pas interchangeables. Les dates sont exactes au format YYYY-MM-DD (années 1000–9999). Les téléphones, codes postaux, SIRET et identifiants sociaux restent des chaînes.

Les dates métier suivent le fuseau configuré de votre application. Les quotas, l’expiration des accès et l’historique API sont exprimés en UTC. Les textes libres sont des textes, pas du HTML à exécuter. Aucun mot de passe ou jeton de réinitialisation n’est retourné. Les emails optionnels de contact peuvent être vides ; les emails non vides doivent être valides.

Tester les jetons avec GET /auth/check

Vérifier la connexion. Vérifie les deux jetons et les règles d’accès actuelles. Aucun corps de requête. Réponse sans données personnelles. Cette requête consomme les mêmes quotas authentifiés.

Permission : authentification valide. Les deux jetons restent obligatoires.

Exemple de réponse :

{
  "success": true,
  "request_id": "req_0123456789abcdef0123456789abcdef",
  "data": {
    "authenticated": true
  }
}