Aller au contenu principal

Authentification API

Toutes les requêtes API v2 nécessitent une authentification via un token Bearer.

Fonctionnement​

  1. Générez une clé API dans Paramètres > Clés API
  2. Incluez-la dans l'en-tête Authorization de chaque requête :
Authorization: Bearer YOUR_API_KEY_HERE

Exemple (cURL)​

curl -X GET "https://yourdomain.com/api/v2/submissions" \
  -H "Authorization: Bearer fp_key_abc123xyz789" \
  -H "Accept: application/json"

Exemple (JavaScript)​

const response = await fetch('https://yourdomain.com/api/v2/submissions', {
  headers: {
    'Authorization': 'Bearer fp_key_abc123xyz789',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

Exemple (PHP)​

$client = new \GuzzleHttp\Client();
$response = $client->get('https://yourdomain.com/api/v2/submissions', [
    'headers' => [
        'Authorization' => 'Bearer fp_key_abc123xyz789',
        'Accept' => 'application/json',
    ]
]);
$data = json_decode($response->getBody(), true);

Exemple (Python)​

import requests

headers = {
    'Authorization': 'Bearer fp_key_abc123xyz789',
    'Accept': 'application/json'
}

response = requests.get('https://yourdomain.com/api/v2/submissions', headers=headers)
data = response.json()

Sécurité​

FonctionnalitéDétail
StockageLes clés sont hachées en SHA256 dans la base de données
PortéeLes clés sont limitées à un locataire spécifique
SuiviL'horodatage last_used_at est mis à jour à chaque utilisation
ExpirationLes clés peuvent avoir des dates d'expiration optionnelles
RévocationLes clés peuvent être révoquées instantanément depuis les paramètres

Gestion des clés API​

ActionComment
CréerParamètres > Clés API > Créer une nouvelle clé
VoirVoir le nom de la clé, la date de création, la dernière utilisation
RévoquerCliquer sur Révoquer pour désactiver définitivement une clé
attention

La clé complète n'est affichée qu'une seule fois lors de la création. Stockez-la en toute sécurité. Si elle est perdue, révoquez-la et créez-en une nouvelle.

Étapes suivantes​