Passer au contenu principal
GET
Pour les téléchargements de fichiers supérieurs à 10 Mo, obtenez une URL présignée pour télécharger un fichier.
  • Taille maximale de téléchargement du fichier : 5 Go.
  • L’URL présignée de téléchargement est valide pendant 30 minutes après sa génération.
  • L’URL d’accès est disponible pendant 30 jours après le téléchargement. Toutes les publications déjà publiées ne sont pas affectées sur les réseaux sociaux. Les publications programmées au-delà de cette période entraîneront des erreurs au moment de la publication.
Si vos médias sont déjà accessibles via une URL externe, comme un bucket S3, vous pouvez ignorer le téléchargement des fichiers vers Ayrshare. Effectuez simplement un POST vers le point de terminaison /post avec votre URL accessible en externe dans le paramètre de corps mediaURLs et votre fichier sera automatiquement téléchargé.

Paramètres d’en-tête

Paramètres de requête

fileName
string
Si le contentType n’est pas présent, un nom de fichier complet avec extension est requis.Nom du fichier à télécharger. Doit inclure une extension telle que .png, .jpg, .mov, .mp4, etc.
contentType
string
Le content-type du média à télécharger. Les formats valides comprennent : mp4, mov, png, jpg ou jpeg.Par exemple, si le fichier est un fichier QuickTime .mov, alors le contentType doit être mov.S’il n’est pas présent, application/octet-stream sera utilisé.

Détails de la réponse

  • accessUrl est l’URL pour accéder au fichier média après le téléchargement.
  • contentType est le content-type défini pour le média à télécharger. Utilisez-le dans l’en-tête Content-Type lors du téléchargement du média.
  • uploadUrl est l’URL utilisée pour PUT le fichier média. Voir ci-dessous.

Exemples de points de terminaison supplémentaires

Le processus pour télécharger des fichiers plus volumineux :
  • Obtenez une uploadURL et une accessURL via le point de terminaison /media/uploadUrl. Voir ci-dessus.
  • Téléchargez le fichier via un PUT avec Content-Type défini sur le contentType retourné.
  • Téléchargez le média en utilisant --upload-file avec un fichier média et l’uploadUrl.
  • En cas de téléchargement réussi, une réponse 200 sera retournée.
  • Après avoir téléchargé le fichier média, effectuez un POST vers le point de terminaison /post avec l’accessUrl dans le paramètre de corps mediaUrls.
  • L’URL présignée de téléchargement ne peut être utilisée qu’une seule fois pour un téléchargement. Si vous avez envoyé un mauvais fichier, vous devez créer une nouvelle URL de téléchargement. Aucune réponse d’erreur ne se produira si le fichier n’est pas téléchargé avec succès. Voir ci-dessous pour vérifier que l’URL existe.
Veillez à ce que le contentType défini lors de la création de l’uploadUrl corresponde au Content-Type et au type de fichier lors du PUT du fichier. Par exemple, si vous définissez le contentType sur “image/png” lors de la création de l’uploadUrl, veillez à définir Content-Type: image/png et que le fichier téléchargé se termine par .png. En cas de téléchargement réussi, une réponse 200 sera retournée.

Exemple de téléchargement de fichier binaire dans Node.js

Voici un exemple de téléchargement d’un fichier média binaire à l’aide de Node avec JavaScript :

Exemple de téléchargement de fichier binaire dans Postman

Vous pouvez également utiliser Postman pour télécharger le fichier binaire vers l’uploadUrl. Dans Postman :
  1. Sélectionnez la méthode HTTP PUT.
  2. Collez votre uploadUrl dans le champ url. Notez que l’url expirera après une heure et ne peut être utilisée qu’une seule fois. Si vous effectuez un appel qui échoue, vous devez régénérer l’uploadUrl.
  3. Dans Headers, définissez le Content-Type sur le content type retourné dans le point de terminaison /uploadUrl. Par exemple : Content-Type: image/png.
  4. Sélectionnez Body -> binary et sélectionnez le fichier à télécharger.
  5. Appuyez sur Send.
  6. Important : aucune réponse de retour ne se produira, vous devez donc vérifier si le téléchargement a réussi en ouvrant l’accessUrl retournée depuis le point de terminaison /uploadUrl dans un navigateur. Vous pouvez également utiliser le point de terminaison de vérification d’URL.
Postman Binary Upload

Postman Sample JSON File