Aller au contenu
Wbiztool

API des médias

API d'obtention d'un fichier multimédia

Obtenez les détails et l'URL de téléchargement d'un fichier de votre bibliothèque de médias à partir de son ID. Utilisez-la pour vérifier qu'un fichier existe toujours avant de l'envoyer.

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

Corps: Chaîne de requête, ou corps JSON avec POST

Remplacez {media_id} dans le chemin par l'id renvoyé par Téléverser un média ou Lister les médias, par exemple /api/v1/media/5122/.

Exemple rapide#

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

Remplacez 12345 et YOUR_API_KEY par vos propres valeurs. Consultez Authentification pour savoir où les trouver.

Paramètres de la requête#

Envoyez client_id et api_key dans la chaîne de requête d'une requête GET, ou dans un corps JSON d'une requête POST. Si client_id figure dans la chaîne de requête, le corps JSON est ignoré.

Chemin

media_idintegerobligatoire

ID du fichier multimédia. Il doit s'agir d'un nombre entier ; toute autre valeur renvoie une réponse HTML « page introuvable » au lieu de JSON.

Authentification

client_idintegerobligatoire

Votre ID client API, dans Paramètres → Clés API.

api_keystringobligatoire

Votre clé API, sur cette même page.

Réponse#

{
  "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]"
  }
}
ChampTypeDescription
statusinteger1 en cas de succès, 0 si la requête a échoué.
messagestringMedia file retrieved successfully, sinon l'erreur.
data.idintegerID du fichier multimédia.
data.file_namestringNom sous lequel le fichier est stocké.
data.original_file_namestringLe nom du fichier au moment de son téléversement.
data.file_urlstringURL de téléchargement direct. Utilisez-la comme img_url ou file_url lors de l'envoi.
data.file_typestringimage ou file.
data.file_sizeintegerTaille en octets.
data.file_size_displaystringTaille lisible avec une décimale, par exemple 242.5 KB.
data.mime_typestringType MIME, par exemple application/pdf.
data.is_imagebooleantrue lorsque file_type vaut image.
data.file_extensionstringExtension de original_file_name en minuscules, sans le point.
data.created_atstringDate du téléversement, au format ISO 8601 en UTC avec un décalage +00:00.
data.modified_atstringDate de dernière modification de l'enregistrement du fichier, au même format.
data.uploaded_bystring or nullNom d'utilisateur de connexion (généralement l'adresse e-mail) du membre de l'équipe qui a téléversé le fichier.

Erreurs#

Les erreurs renvoient aussi le code HTTP 200, avec status à 0 :

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

Une exception : si media_id n'est pas un nombre, l'URL ne correspond à aucun endpoint et vous recevez une page HTML 404 au lieu de JSON.

MessageComment corriger
client_id is requiredAjoutez client_id.
api_key is requiredAjoutez api_key.
client_id must be a valid integerEnvoyez client_id sous forme de nombre.
Invalid API keyVérifiez que la clé existe et n'a pas été supprimée ni désactivée.
Invalid client_id for this API keyLa clé appartient à un autre client_id.
Media file not foundAucun fichier avec cet ID n'existe dans l'espace de travail de la clé API, ou il a été supprimé.
Error retrieving media file: …Un problème est survenu de notre côté. Réessayez.

Vérifier un fichier avant de l'envoyer#

Récupérez le fichier par son ID, arrêtez-vous s'il n'existe plus, puis envoyez son file_url : comme img_url avec msg_type 1 pour les images, ou comme file_url avec msg_type 2 pour tout le reste.

Envoyer un fichier multimédia enregistré
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())

Les fichiers autres que des images, comme .doc, .ppt, .csv, .zip, .wav et .mov, sont remis avec .pdf ajouté à leur nom, et l'envoi des images de plus de 16 Mo échoue. Consultez Téléverser un média → Téléverser puis envoyer.

Conseils#

  • Les fichiers supprimés renvoient Media file not found, même si leur file_url peut encore permettre le téléchargement. Vérifiez avec cet endpoint plutôt qu'en récupérant l'URL. Les URL des fichiers téléversés sont publiques et permanentes ; consultez Téléverser un média → Téléverser puis envoyer.
  • Les fichiers sont propres à chaque espace de travail. Un fichier téléversé dans un espace de travail ne peut pas être lu avec une clé API d'un autre espace.
  • Vous ne connaissez pas l'ID ? Recherchez par nom avec Lister les médias.