Passer au contenu principal
POST
/
api
/
v1
/
files
/
upload
/
url
Téléchargement de fichier par URL
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_url": "https://example.com/image.jpg"
}
'
{
  "success": true,
  "code": 200,
  "msg": "Fichier téléversé avec succès",
  "data": {
    "file_id": "file_abc123",
    "file_name": "downloaded.jpg",
    "original_name": "downloaded.jpg",
    "file_size": 2048,
    "mime_type": "image/jpeg",
    "upload_path": "downloads",
    "file_url": "https://files.evolink.ai/downloads/downloaded.jpg",
    "download_url": "https://files.evolink.ai/api/v1/files/download/file_abc123",
    "upload_time": "2025-10-09T00:00:00+08:00",
    "expires_at": "2025-10-12T00:00:00+08:00"
  }
}

Autorisations

​
Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json
​
file_url
string<uri>
requis

URL du fichier distant

Exigences :

  • Doit être une URL accessible publiquement
  • Prend en charge les protocoles HTTP et HTTPS
  • Le système téléchargera automatiquement le contenu du fichier depuis cette URL
  • Maximum 1 image par requête
  • Prend actuellement en charge le téléchargement de fichiers dans les formats suivants uniquement : image/jpeg, image/png, image/gif, image/webp
Exemple:

"https://example.com/image.jpg"

​
upload_path
string

Chemin de téléversement personnalisé

Remarque :

  • Si non spécifié, le système catégorisera automatiquement en fonction du type de fichier
Exemple:

"downloads"

​
file_name
string

Nom de fichier personnalisé

Remarque :

  • Si non spécifié, le système générera automatiquement un nom de fichier unique
Exemple:

"downloaded.jpg"

Réponse

200 - application/json

Fichier téléversé avec succès

​
success
boolean

Si la requête a réussi

Exemple:

true

​
code
integer

Code de statut de la réponse

Exemple:

200

​
msg
string

Message de réponse

Exemple:

"Fichier téléversé avec succès"

​
data
object