API
Références de l'API
Créer un fichier

Créer un fichier

POST /files/create

Paramètres

Body : application/json (recommandé) ou application/x-www-form-urlencoded

{
  "filename": "nom du fichier", // facultatif, sera "Sans nom" si non défini, limité à 200 caractères
  "filesize": "taille du fichier en octets", // obligatoire, limité à la taille maximale de l'instance
  "sharekey": "clé de partage", // facultatif, limité à 30 caractères, sans caractères spéciaux, en minuscules
  "expiretime": "temps d'expiration en secondes", // obligatoire, inférieur à 2 592 000
}

Authentification

Si l'instance est protégée par un mot de passe, un header Authorization doit être présent avec le mot de passe de l'instance comme valeur. Il sera ignoré si l'instance n'est pas protégée par un mot de passe.

Réponse

{
  "fileSize": "taille du fichier en octets", // taille que vous avez envoyée
  "shareKey": "clé de partage", // clé générée aléatoirement, ou celle que vous avez envoyée
  "expireTime": "temps d'expiration en secondes", // temps que vous avez envoyé
  "created": 1689794692135, // date de création en millisecondes
  "transferKey": "kob60erqard6", // clé de transfert, à utiliser pour envoyer les chunks
  "uploaded": false, // false, car le fichier n'a pas encore été envoyé dans son intégralité
  "chunkEvery": 20000000, // taille d'un chunk en octets
  "chunks": [ // liste de tous les chunks à envoyer
    {
      "pos": 0, // position du chunk
      "uploaded": false, // false, car le chunk n'a pas encore été envoyé
      "size": 723955, // taille du chunk en octets, doit être respecté
      "uploadPath": "/files/uploadChunk?transferkey=kob60erqard6&chunk=0" // chemin de l'API à utiliser pour envoyer le chunk
    }
  ]
}

Ou une erreur pour de nombreuses raisons.