Gérez vos identifiants storag3 par API

L'utilisation de l'API nécessite l'utilisation d'un token. Rendez-vous donc dans votre Dashboard Leviia, puis dans le menu "Tokens API" à gauche (1). Cliquez 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.

• 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é.

• Route : https://backend.api.leviia.com/api/v1/object-storage/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/object-storage/identifiers' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer _YourBearerToken_'

• Route : https://backend.api.leviia.com/api/v1/object-storage/identifiers
• Méthode : POST
• Paramètres : Aucun
• Headers : Authorization: Bearer {yourBearerToken}
• Body : au format JSON, avec les informations 'display_name', 'quota' et 'zone'.

• Les zones disponibles à la création d'un identifiant sont : lyon et marseille.
• Vous pouvez ne pas renseigner la zone, et laisser notre système créer automatiquement l'identifiant sur l'une des zones disponibles
• Si vous souhaitez choisir la zone, veillez à vérifier qu'elle soit disponible (via le Dashboard Leviia, en créant un nouvel identifiant), sinon vous recevrez l'erreur suivante "impossible to create the identifier on this zone. Try another one that is available."

Exemple de requête cURL :

curl -X 'POST' \
  'https://backend.api.leviia.com/api/v1/object-storage/identifiers' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer _yourBearerToken_' \
  -H 'Content-Type: application/json' \
  -d '{
  "display_name": "Nouvel identifiant",
  "quota": 1,
  "zone": ""
}'

• Route : https://backend.api.leviia.com/api/v1/object-storage/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/object-storage/identifiers/identifiant_leviia_xxXXXxXXxx' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer _yourBearerToken_' \
  -H 'Content-Type: application/json' \
  -d '{
  "display_name": "Le nouveau nom de mon identifiant",
  "suspended": false,
  "quota": 1.5
}'

• Route : https://backend.api.leviia.com/api/v1/object-storage/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/object-storage/identifiers/identifiant_leviia_xxXXXxXXxx' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer _yourBearerToken_'

Vous pouvez récupérer deux informations :

• Le quota alloué (quota_allocated) : il s'agit du total des quota des identifiants de votre forfait
• Votre forfait (quota_allowed) : il s'agit de la quantité de stockage souscrite

• Route : https://backend.api.leviia.com/api/v1/object-storage/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/object-storage/quota' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer _yourBearerToken_'

Mis à jour le : 25/09/2025