Passer au contenu principal
POST
Ce point de terminaison vous permet de télécharger un fichier, une image ou une petite vidéo à inclure dans votre publication. L’URL de l’image, qui peut être utilisée dans le point de terminaison /post, sera retournée. Vous pouvez transmettre le fichier soit sous forme de multipart form data comme paramètre de formulaire, soit sous forme de fichier encodé en Base64 comme paramètre de corps. Notes importantes sur les téléchargements de médias :
  1. Pour de meilleures performances, nous recommandons
    • d’héberger les fichiers médias sur votre propre serveur (par ex. AWS S3).
    • de transmettre l’URL du média directement dans le paramètre mediaUrls du point de terminaison /post.
    • Cette approche est plus rapide que de télécharger des fichiers via ce point de terminaison.
  2. Rétention des fichiers médias
    • Les fichiers téléchargés sont stockés pendant 90 jours.
    • Après 90 jours :
      • Les publications déjà publiées sur les réseaux sociaux ne sont pas affectées.
      • Les publications programmées ne parviendront pas à être publiées si elles référencent un média expiré.
  3. Limites de taille de fichier
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

Content-Type
string
requis
Utilisez multipart/form-data si vous envoyez des données multipart form - voir ci-dessous. Sinon, envoyez le standard application/json.

Paramètres du corps

file
string or object
requis
Taille de fichier max 30 Mo.Nous recommandons d’envoyer sous forme d’objet multipart form-data plutôt qu’en encodage Base64.
fileName
string
Le nom du fichier à télécharger.
description
string
Une description du fichier.

Envoyer en Multipart Form-Data

Envoyez le fichier média sous forme d’objet multipart form-data. Veillez à spécifier le Content-Type comme mentionné ci-dessus.

Envoyer en Base64

Envoyez le fichier média sous forme de chaîne encodée en Base64 comme chaîne Data URI. La chaîne doit commencer par data:content/type;base64 Exemple d’encodage avec le format de sortie Data URI : Remarque : le point de terminaison /post accepte des fichiers plus volumineux via une URL externe avec le paramètre mediaUrls.