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

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Importar o subir un medio

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Importar desde una URL

Envía JSON con el establishmentId y una url https pública. Sofia descarga el archivo ella misma, lo comprueba y lo guarda en la biblioteca multimedia.

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

Subir un archivo

O envía el propio archivo en multipart/form-data, con un campo file.

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -F establishmentId=$ESTABLISHMENT_ID \
  -F file=@tatin.jpg

{
  "id": "393d5aa4-16f1-430f-b1d8-1fb1473076ef",
  "type": "image",
  "url": "https://…/393d5aa4-16f1-430f-b1d8-1fb1473076ef.jpg?X-Amz-…"
}

Lo que se acepta

Imágenes y vídeos, hasta 200 MB.
Una URL debe ser https pública: se rechazan una dirección privada, más de 3 redirecciones o más de 30 segundos de descarga.
La url devuelta está firmada y caduca: conserva el id, y vuelve a leer el archivo con GET /v1/media/{id} cuando necesites una URL nueva.

Un archivo rechazado responde 422 media_import_refused o media_upload_refused, con el motivo en details y los pasos a seguir en message.

Autorizaciones

Authorizationstringheaderobligatorio
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

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

¿Te ha resultado útil esta página?