Authentication

Note

L’API Magistral utilise une authentification basée sur les tokens JWT (JSON Web Tokens) pour sécuriser toutes les communications. Cette page détaille tout ce que vous devez savoir sur l’authentification.

Obtention des Credentials

Création du Compte

1. Rendez-vous sur le portail Magistral
2. Remplissez le formulaire d’inscription
3. Vérifiez votre email et activez votre compte
4. Connectez-vous à votre tableau de bord

Génération du Token API

Dans votre tableau de bord :

1. Accédez à Paramètres > API Keys
2. Cliquez sur “Générer une nouvelle clé”
3. Donnez un nom à votre clé (ex: “Production”, “Test”, etc.)
4. Copiez immédiatement votre token - il ne sera plus jamais affiché

Utilisation du Token

Format de l’En-tête

Toutes les requêtes doivent inclure votre token dans l’en-tête HTTP :

Authorization: Bearer votre_token_jwt

Exemple de Requête

JavaScript

Exemple de requête

async function sendRequest(data) {
  const response = await fetch('https://api.magistral.com/v1/endpoint', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${VOTRE_TOKEN_API}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
  });

  return await response.json();
}

Python

Exemple de requête

import requests

def send_request(data):
    response = requests.post(
        'https://api.magistral.com/v1/endpoint',
        headers={
            'Authorization': f'Bearer {VOTRE_TOKEN_API}',
            'Content-Type': 'application/json'
        },
        json=data
    )

    return response.json()

Shell

Exemple de requête

curl -X POST "https://api.magistral.com/v1/endpoint" \
-H "Authorization: Bearer ${VOTRE_TOKEN_API}" \
-H "Content-Type: application/json" \
-d '{
  "key": "value"
}'

Danger

Ne partagez jamais votre token

• Ne le commitez pas dans votre code source
• Ne l’envoyez pas par email
• Ne l’incluez pas dans les logs

Utilisez des variables d’environnement

.env

MAGISTRAL_API_KEY=votre_token_jwt

// code
const apiKey = process.env.MAGISTRAL_API_KEY;