MediaImportare o caricare un media
Torna a Sofia

Media

Importare o caricare un media

Aggiunge alla mediateca di un'attività un file (multipart) o un URL https che Sofia scarica. Richiede un'app live e un abbonamento attivo.

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

Questa richiesta agisce sul tuo account reale.

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

Autorizzazioni

  • Authorizationstringobbligatorio

    La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Header

  • Idempotency-Keystring

    Ripetuta con lo stesso body, la richiesta restituisce la stessa risposta senza una seconda importazione. Copre i campi del modulo, non i byte del file.

Body

application/json, multipart/form-data

  • establishmentIdstringobbligatorio

    L'attività la cui mediateca riceve il media

  • urlstring

    JSON: l'indirizzo https del media, che Sofia scarica da sola (nessun file)

  • filestring<binary>

    multipart/form-data: il file (immagine o video), senza url

Risposta

201application/json

Il media aggiunto alla mediateca.

  • idstringobbligatorio

    Identificatore del media, da passare in media[].id di una pubblicazione

  • typestringobbligatorio

    Tipo del media

    Valori ammessi: imagevideo

  • urlstringobbligatorio

    Indirizzo firmato, valido per la finestra corrente

400

Body malformato.

401

Il token manca, è sconosciuto, scaduto o revocato.

402

subscription_required.

403

live_mode_required per un'applicazione di test, oppure manca il permesso media:write.

404

Attività fuori dal Workspace del token.

413

payload_too_large: oltre il limite di dimensione dell'app.

422

media_import_refused, con il suo motivo: private_address, too_large, unsupported_media, unreachable, timeout, invalid_url, redirect_limit o removed_from_library. media_upload_refused per un file.

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.