Utiliser l'API pour gérer vos identifiants S3
Afin de gérer vos identifiants S3 via l'API vous devez tout d'abord créer un token d'API.
Création d'un token
Depuis votre Dashboard Leviia, aller dans le menu "Tokens API" à gauche (1), la liste des tokens déjà créés s'affiche, puis cliquer sur le bouton "Créer un token" (2).
Définissez ensuite une description pour ce token (1) (ceci vous permettra de l'identifier dans la liste des tokens), puis une date d'expiration (2) avant de cliquer sur "Générer".
Votre token généré s'affiche, vous pouvez le copier dès cette étape, ou le copier ultérieurement depuis la liste des tokens.
Utilisation de l'API
L'URL de base pour joindre l'API est :https://backend.api.leviia.com/api/v1/Les requêtes vers l'API doivent être authentifiées avec un token de type Bearer. Ce token doit être actif et dans la période de validité.Récupérer la liste des identifiants S3
- Route :
https://backend.api.leviia.com/api/v1/s3/identifiers - Méthode :
GET - Paramètres : Aucun
- Headers :
Authorization: Bearer {your_api_token}
Exemple de requête cURL :
curl -X 'GET' \
'https://backend.api.leviia.com/api/v1/s3/identifiers' \
-H 'accept: application/json' \
-H 'Authorization: Bearer _YourBearerToken_'
Créer un nouvel identifiant S3
- Route :
https://backend.api.leviia.com/api/v1/s3/identifiers - Méthode :
POST - Paramètres : Aucun
- Headers :
Authorization: Bearer {yourBearerToken} - Body : au format JSON, avec les informations display_name et quota.
Exemple de requête cURL :
curl -X 'POST' \
'https://backend.api.leviia.com/api/v1/s3/identifiers' \
-H 'accept: application/json' \
-H 'Authorization: Bearer _yourBearerToken_' \
-H 'Content-Type: application/json' \
-d '{
"display_name": "Nouveau token",
"quota": 1
}'
Modifier un identifiant S3
- Route :
https://backend.api.leviia.com/api/v1/s3/identifiers/{identifier_id} - Méthode :
PUT - Paramètres :
identifier_id - Headers :
Authorization: Bearer {yourBearerToken} - Body : au format JSON, avec les informations display_name, suspended et quota.
Exemple de requête cURL :
curl -X 'PUT' \
'https://backend.api.leviia.com/api/v1/s3/identifiers/identifiant_leviia_xxXXXxXXxx' \
-H 'accept: application/json' \
-H 'Authorization: Bearer _yourBearerToken_' \
-H 'Content-Type: application/json' \
-d '{
"display_name": "Nouveau super token",
"suspended": false,
"quota": 1.5
}'
Supprimer un identifiant S3
- Route :
https://backend.api.leviia.com/api/v1/s3/identifiers/{identifier_id} - Méthode :
DELETE - Paramètres :
identifier_id - Headers :
Authorization: Bearer {yourBearerToken}
Exemple de requête cURL :
curl -X 'DELETE' \
'https://backend.api.leviia.com/api/v1/s3/identifiers/identifiant_leviia_xxXXXxXXxx' \
-H 'accept: application/json' \
-H 'Authorization: Bearer _yourBearerToken_'
Obtenir les informations sur le quota S3
- Route :
https://backend.api.leviia.com/api/v1/s3/quota - Méthode :
GET - Paramètres : Aucun
- Headers :
Authorization: Bearer {yourBearerToken}
Exemple de requête cURL :
curl -X 'GET' \
'https://backend.api.leviia.com/api/v1/s3/quota' \
-H 'accept: application/json' \
-H 'Authorization: Bearer _yourBearerToken_'
Mis à jour le : 26/05/2025
Merci !