API médiaAPI

Importez une fois, publiez partout

Envoyez un fichier dans la médiathèque et récupérez un id. Joignez cet id à autant de publications que vous voulez, et FoPost le convertit et le diffuse au format attendu par chaque réseau. Le stockage est privé et limité à l'espace de travail.

Obtenir votre clé APILire la documentation
POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"

{
  "data": [
    {
      "id": "e5a1c9d4-...",
      "type": "image",
      "name": "launch.png",
      "url": "https://.../launch.png",
      "preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
      "size": 412883
    }
  ]
}

Import multipart

Images et vidéos jusqu'à 50 MB, validées sur leur contenu et pas seulement leur extension.

Réutilisation par id

Un import, autant de publications que vous voulez. Le fichier n'est jamais envoyé deux fois.

Privé par défaut

Les fichiers sont conservés dans un stockage privé et servis uniquement aux membres de l'espace de travail.

Import

Une seule entrée, contrôlée à l'arrivée

Chaque fichier suit le même chemin : liste de types MIME autorisés, contrôle des octets réels, taille maximale et quota de stockage gratuit de votre compte. Vous récupérez une entrée de médiathèque avec son type et sa taille, prête à être jointe.

Lire la référence média
Joindre à une publication
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
    "accounts": ["4a71d80b-..."]
  }'

Images

PNG, JPEG, GIF et WebP, avec type et taille lus à l'import.

Vidéo

MP4 et MOV, avec durée et taille vérifiées pour chaque réseau au moment de la publication.

Validé

Le contenu réel du fichier doit correspondre à son type, sinon l'import est refusé.

Diffusion

Le bon format pour chaque réseau, sans effort

Les réseaux ne s'accordent ni sur les ratios, ni sur les tailles, ni sur les codecs. Au moment de la publication, chaque adaptateur prend l'original stocké et envoie ce que la plateforme accepte : une seule ressource de médiathèque fonctionne aussi bien pour un carrousel, un thread qu'un flux de vidéos courtes.

Voir le fonctionnement de la diffusion
Images de marque organisées dans la médiathèque partagée

Règles par réseau

Les limites de taille et de format sont appliquées par l'adaptateur, pas par vous.

Médias ordonnés

L'ordre dans le bloc de contenu est l'ordre du carrousel.

Des échecs clairs

Un fichier refusé par un réseau fait échouer cette diffusion, avec la raison, et non toute la publication.

Gérer

Parcourez, récupérez et réutilisez la médiathèque

Listez la médiathèque avec des filtres, récupérez n'importe quelle ressource via un endpoint de fichier qui vérifie l'appartenance à l'espace de travail à chaque requête et n'expire jamais, et référencez le même id dans autant de publications que vous voulez. Ressources de marque, imports et images générées arrivent tous dans la même médiathèque.

Commencer à développer
GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
  -H "X-API-Key: $API_KEY"

# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
  -H "X-API-Key: $API_KEY" -o launch.png

Lister et filtrer

Par type, origine ou rôle de marque, avec pagination.

URL de fichier stable

/v1/media/:id/file always works for members; no signed links to refresh.

Limité à l'espace de travail

Une clé voit la médiathèque d'un seul espace de travail, et rien d'autre.

API média : vos questions, nos réponses

Quelle est la taille maximale ?

50 MB par fichier. Chaque réseau a ses propres plafonds, vérifiés lorsqu'une publication est diffusée sur ce réseau.

Quels formats sont acceptés ?

Les formats d'image courants (PNG, JPEG, GIF, WebP) et de vidéo (MP4, MOV). L'import contrôle les octets réels du fichier : un fichier renommé est refusé.

Puis-je joindre un id de média à plusieurs publications ?

Oui. C'est tout l'intérêt de la médiathèque. Importez une fois et référencez l'id depuis n'importe quelle publication de l'espace de travail.

Les fichiers importés sont-ils publics ?

Non. Le stockage est privé. L'endpoint de fichier vérifie l'appartenance à l'espace de travail à chaque requête, et les réseaux ne reçoivent un lien de courte durée qu'au moment de la publication.

Est-ce décompté d'un quota ?

Oui, chaque compte inclut un quota de stockage gratuit, et le stockage au-delà est facturé par GB et par mois si une carte est enregistrée. Chaque import et chaque image générée sont décomptés de la même manière.

Puis-je importer depuis une URL ou un outil de design ?

Oui, les imports arrivent dans la même médiathèque et conservent une référence à leur source : vous pouvez récupérer un design mis à jour sur place au lieu d'importer un nouveau fichier.

Développez avec API média dès aujourd'hui

Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.

Obtenir votre clé API