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