Vai al contenuto
Wbiztool

API file multimediali

API Ottieni file multimediale

Ottieni i dettagli e l'URL di download di un file della tua libreria multimediale tramite il suo ID. Usala per verificare che un file esista ancora prima di inviarlo.

GEThttps://wbiztool.com/api/v1/media/{media_id}/

Corpo: Query string, oppure un corpo JSON con POST

Sostituisci {media_id} nel percorso con l'id restituito da Carica file multimediali o Elenca file multimediali, ad esempio /api/v1/media/5122/.

Esempio rapido#

curl -G https://wbiztool.com/api/v1/media/5122/ \
  --data-urlencode client_id=12345 \
  --data-urlencode api_key=YOUR_API_KEY

Sostituisci 12345 e YOUR_API_KEY con i tuoi valori. Consulta Autenticazione per sapere dove trovarli.

Parametri della richiesta#

Invia client_id e api_key nella query string di una richiesta GET, oppure come corpo JSON in una richiesta POST. Se client_id è nella query string, il corpo JSON viene ignorato.

Percorso

media_idintegerobbligatorio

ID del file multimediale. Deve essere un numero intero; qualsiasi altro valore restituisce una risposta HTML «pagina non trovata» invece di JSON.

Autenticazione

client_idintegerobbligatorio

Il tuo ID Client API, da Impostazioni → Chiavi API.

api_keystringobbligatorio

La tua chiave API, dalla stessa pagina.

Risposta#

{
  "status": 1,
  "message": "Media file retrieved successfully",
  "data": {
    "id": 5122,
    "file_name": "media_12345_17895804001234.pdf",
    "original_file_name": "invoice-4821.pdf",
    "file_url": "https://wbiztool-static.s3.ap-southeast-1.amazonaws.com/media/org_12345/media_12345_17895804001234.pdf",
    "file_type": "file",
    "file_size": 248312,
    "file_size_display": "242.5 KB",
    "mime_type": "application/pdf",
    "is_image": false,
    "file_extension": "pdf",
    "created_at": "2026-09-16T10:20:31.512934+00:00",
    "modified_at": "2026-09-16T10:20:31.512961+00:00",
    "uploaded_by": "[email protected]"
  }
}
CampoTipoDescrizione
statusinteger1 in caso di successo, 0 se la richiesta non è riuscita.
messagestringMedia file retrieved successfully, altrimenti l'errore.
data.idintegerID del file multimediale.
data.file_namestringNome con cui è salvato il file.
data.original_file_namestringIl nome che aveva il file quando è stato caricato.
data.file_urlstringURL di download diretto. Usalo come img_url o file_url durante l'invio.
data.file_typestringimage o file.
data.file_sizeintegerDimensione in byte.
data.file_size_displaystringDimensione leggibile con un decimale, ad esempio 242.5 KB.
data.mime_typestringTipo MIME, ad esempio application/pdf.
data.is_imagebooleantrue quando file_type è image.
data.file_extensionstringEstensione in minuscolo di original_file_name, senza il punto.
data.created_atstringOrario del caricamento, in formato ISO 8601 in UTC con l'offset +00:00.
data.modified_atstringL'ultima modifica del record del file, nello stesso formato.
data.uploaded_bystring or nullNome utente di accesso (di solito l'indirizzo email) del membro del team che ha caricato il file.

Errori#

Anche gli errori restituiscono HTTP 200, con status impostato su 0:

{ "status": 0, "message": "Media file not found" }

Un'eccezione: se media_id non è un numero, l'URL non corrisponde a nessun endpoint e ricevi una pagina HTML 404 invece di JSON.

MessaggioCome risolvere
client_id is requiredAggiungi client_id.
api_key is requiredAggiungi api_key.
client_id must be a valid integerInvia client_id come numero.
Invalid API keyVerifica che la chiave esista e non sia stata eliminata o disattivata.
Invalid client_id for this API keyLa chiave appartiene a un altro client_id.
Media file not foundNello spazio di lavoro della chiave API non esiste alcun file con questo ID, oppure è stato eliminato.
Error retrieving media file: …Si è verificato un problema da parte nostra. Riprova.

Verificare un file prima di inviarlo#

Recupera il file tramite ID, fermati se non esiste più, poi invia il suo file_url: come img_url con msg_type 1 per le immagini, oppure come file_url con msg_type 2 per tutto il resto.

Invia un file multimediale salvato
import requests

BASE = "https://wbiztool.com/api/v1"
AUTH = {"client_id": 12345, "api_key": "YOUR_API_KEY"}

result = requests.get(f"{BASE}/media/5122/", params=AUTH, timeout=60).json()
if result["status"] != 1:
    raise SystemExit("Can't use this file: " + result["message"])

media = result["data"]
message = {
    **AUTH,
    "whatsapp_client": 678,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Here is the document you asked for.",
}
if media["is_image"]:
    message.update(msg_type=1, img_url=media["file_url"])
else:
    message.update(msg_type=2, file_url=media["file_url"], file_name=media["original_file_name"])

print(requests.post(f"{BASE}/send_msg/", json=message, timeout=60).json())

I file non immagine come .doc, .ppt, .csv, .zip, .wav e .mov vengono consegnati con .pdf aggiunto al nome, e le immagini oltre 16 MB non vengono inviate. Vedi Carica file multimediali → Carica e invia.

Suggerimenti#

  • I file eliminati restituiscono Media file not found, anche se il loro file_url potrebbe ancora essere scaricabile. Verifica con questo endpoint anziché scaricando l'URL. Gli URL dei file caricati sono pubblici e permanenti; vedi Carica file multimediali → Carica e invia.
  • I file appartengono a ciascuno spazio di lavoro. Un file caricato in uno spazio di lavoro non può essere letto con una chiave API di un altro.
  • Non conosci l'ID? Cerca per nome con Elenca file multimediali.