MediosImportar o subir un medio
Volver a Sofia

Medios

Importar o subir un medio

Añade a la biblioteca de medios de un establecimiento un archivo (multipart) o una URL https que Sofia descarga. Requiere una app live y suscripción activa.

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

Esta petición actúa sobre tu cuenta real.

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"}'

Autorizaciones

  • Authorizationstringobligatorio

    Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Cabeceras

  • Idempotency-Keystring

    Repetida con el mismo cuerpo, la petición devuelve la misma respuesta sin una segunda importación. Cubre los campos del formulario, no los bytes del archivo.

Cuerpo

application/json, multipart/form-data

  • establishmentIdstringobligatorio

    El establecimiento cuya biblioteca de medios recibe el medio

  • urlstring

    JSON: la dirección https del medio, que Sofia descarga por sí misma (sin archivo)

  • filestring<binary>

    multipart/form-data: el archivo (imagen o vídeo), sin url

Respuesta

201application/json

El medio añadido a la biblioteca.

  • idstringobligatorio

    Identificador del medio, para pasar en media[].id de una publicación

  • typestringobligatorio

    Tipo del medio

    Valores permitidos: imagevideo

  • urlstringobligatorio

    Dirección firmada, válida para la ventana actual

400

Cuerpo mal formado.

401

El token falta, es desconocido, ha caducado o está revocado.

402

subscription_required.

403

live_mode_required para una aplicación de prueba, o falta el permiso media:write.

404

Establecimiento fuera del Workspace del token.

413

payload_too_large: supera el límite de tamaño de la app.

422

media_import_refused, con su motivo: private_address, too_large, unsupported_media, unreachable, timeout, invalid_url, redirect_limit o removed_from_library. media_upload_refused para un archivo.

4XXapplication/json

Cualquier otro error, en el sobre de error.