MédiasImporter ou téléverser un média
Retour à Sofia

Médias

Importer ou téléverser un média

Ajoute à la médiathèque d’un établissement un fichier (multipart) ou une URL https que Sofia récupère. Exige une application live et un abonnement actif.

POSThttps://api.sofia-post.com/api/v1/media
POST/v1/media

Cette requête agit sur votre vrai compte.

curl -X POST 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"establishmentId":"string","url":"https://cdn.example.com/tarte-tatin.jpg"}'

Autorisations

  • Authorizationstringrequis

    Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

En-têtes

  • Idempotency-Keystring

    Rejouée avec le même corps, la requête renvoie la même réponse sans second import. Elle couvre les champs du formulaire, pas les octets du fichier.

Corps

application/json, multipart/form-data

  • establishmentIdstringrequis

    L’établissement dont la médiathèque reçoit le média

  • urlstring

    JSON : l’adresse https du média, que Sofia récupère elle-même (pas de fichier)

  • filestring<binary>

    multipart/form-data : le fichier (image ou vidéo), sans url

Réponse

201application/json

Le média ajouté à la médiathèque.

  • idstringrequis

    Identifiant du média, à passer dans media[].id d’une publication

  • typestringrequis

    Type du média

    Valeurs autorisées : imagevideo

  • urlstringrequis

    Adresse signée, valable pour la fenêtre en cours

400

Corps mal formé.

401

Le jeton est absent, inconnu, expiré ou révoqué.

402

subscription_required.

403

live_mode_required pour une application de test, ou la permission media:write manque.

404

Établissement hors du Workspace du jeton.

413

payload_too_large : au-delà de la taille maximale de l’app.

422

media_import_refused, avec sa raison : private_address, too_large, unsupported_media, unreachable, timeout, invalid_url, redirect_limit ou removed_from_library. media_upload_refused pour un fichier.

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.