Authentification

Les extraits de code de cette page supposent que les constantes suivantes sont définies.

Variable	Contenu
URL_SERVER	"https://extract.api.recital.ai/extract/api/v1"
URL_AUTH	"https://extract.auth.recital.ai/auth/api/v1/login/?noAuth=true"
API_TOKEN	"xxxx"
USER	"xxx@xxx.x"
PWD	"xxx"

Via un token de service (recommandé)

Des tokens de service peuvent être générés depuis la page de configuration de l'organisation (Paramètre - Généraux).

Générer un token de service

# Tester le token API
import requests

r = requests.post(
    url=f"{URL_SERVER}/config/", 
    headers={"Authorization": f"Bearer {API_TOKEN}"
)

Via ID / Mot de passe

L'authentification via ID/mot de passe vous permet d'obtenir les headers qui seront utilisés dans chaque appel ultérieur de l'API. Le token d'accès généré de cette manière a une durée de vie d'une heure.

# Return headers needed to perform the API calls later
import requests

r = requests.post(url=URL_AUTH, data={"username":USER,"password":PWD})
if r.status_code == 200:
	headers = {"Authorization":f"Bearer {r.json()['access_token']}"}
else:
	raise Exception(f'Authentication Error - {r.status_code} - {r.reason} - {r.content}')