Medios

Endpoints

POST/v1/mediaGET/v1/mediaGET/v1/media/{id}DELETE/v1/media/{id}

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 de medios.

bash

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 como multipart/form-data, con un campo file.

bash

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

json

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

Qué se acepta

Imágenes y vídeos, de 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 medio 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 qué hacer en message.