İçeriğe geç
WbizTool

Medya API'si

Medya yükleme API'si

Çalışma alanınızın Medya klasörüne bir görsel, belge, ses veya video dosyası yükleyin ve bir indirme URL'si alın. Kendi dosya barındırmanız olmadığında bu URL'yi Mesaj gönderme endpoint'ine veya Hatırlatıcı oluşturma endpoint'ine img_url olarak iletin.

POSThttps://wbiztool.com/api/v1/media/upload/

Gövde: multipart/form-data

Dosya hemen kaydedilir ve yanıt dosyanın file_url değerini içerir. Yüklenen dosyalar panelinizdeki Medya klasörü sayfasında da görünür.

Hızlı örnek#

curl -X POST https://wbiztool.com/api/v1/media/upload/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F media_file=@./invoice-4821.pdf

12345 ve YOUR_API_KEY değerlerini kendi değerlerinizle değiştirin. Bunları nerede bulacağınız için Kimlik doğrulama bölümüne bakın.

İstek parametreleri#

İsteği multipart/form-data olarak gönderin. Bu endpoint JSON gövdelerini ve sorgu dizesi parametrelerini okumaz.

AuthorizationheaderÖnerilir

Bearer YOUR_API_KEY: Ayarlar → API anahtarları sayfasındaki API anahtarınız. Bu başlıkla client_id ve api_key gövdeden çıkarılabilir; ikisi birden gönderilirse başlıktaki geçerli anahtar kullanılır. Bkz. Anahtarı başlıkta gönderin.

client_idintegerAuthorization başlığı olmadan

Ayarlar → API anahtarları sayfasındaki API Client ID'niz. Başlıkla isteğe bağlıdır; gönderirseniz anahtarın çalışma alanına ait olmalıdır.

api_keystringAuthorization başlığı olmadan

Aynı sayfadaki API anahtarınız; başlıkta göndermediğinizde.

media_filefilezorunlu

Yüklenecek dosya, en fazla 64 MB; çalışma alanının medya depolama alanına da sığmalıdır. Türü dosya adının uzantısına göre belirlenir; bu yüzden ad desteklenen uzantılardan biriyle bitmelidir.

Desteklenen dosya türleri#

KategoriUzantılar
Görseller.jpg, .jpeg, .png, .gif, .webp, .bmp
Belgeler.pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .txt, .csv
Ses.mp3, .m4a, .wav, .ogg, .aac
Video.mp4, .mov, .avi
Arşivler.zip, .rar

Görseller file_type değeri image olarak kaydedilir; diğer her şey file olur.

Çalışma alanı başına depolama#

Bir çalışma alanının Medya klasöründeki tüm dosyalar, çalışma alanının planına göre belirlenen tek bir depolama sınırını paylaşır. Bu API ile ve Medya klasörü sayfasında yüklenen dosyaların ikisi de sayılır; bir dosyayı silmek onun kapladığı alanı boşaltır.

PlanMedya depolama alanı
Ücretsiz deneme250 MB
Lite1 GB
Standard2 GB
Advanced5 GB
Enterprise10 GB
AppSumo Plan 1 ve Plan 21 GB
AppSumo Plan 32 GB
AppSumo Plan 43 GB
AppSumo Plan 55 GB

Eski planlarda ve aktif planı olmayan bir çalışma alanında 1 GB vardır. Sığmayan bir yükleme Storage full: … ile reddedilir (bkz. Hatalar). Sınırını zaten aşmış bir çalışma alanı dosyalarını korur, ancak yer açılana kadar yeni dosya ekleyemez.

Yanıt#

Başarılı bir istek HTTP 200 döndürür:

{
  "status": 1,
  "message": "File uploaded successfully",
  "data": {
    "id": 5122,
    "file_name": "media_12345_17895804001234_3f9a1c7e.pdf",
    "original_file_name": "invoice-4821.pdf",
    "file_url": "https://wbiztool-static.s3.ap-southeast-1.amazonaws.com/media/org_12345/media_12345_17895804001234_3f9a1c7e.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"
  }
}
AlanTürAçıklama
statusintegerDosya yüklendiyse 1, istek başarısız olduysa 0.
messagestringFile uploaded successfully, aksi halde hata mesajı.
data.idintegerMedya dosyasının ID'si. Medya dosyası getirme ile kullanın.
data.file_namestringDosyanın kaydedildiği, WbizTool tarafından oluşturulan ad: media_, çalışma alanı kimliğiniz, yükleme zamanı ve rastgele bir kısım, ardından dosyanın uzantısı.
data.original_file_namestringYüklediğiniz dosyanın adı.
data.file_urlstringDoğrudan indirme URL'si. Gönderirken img_url veya file_url olarak kullanın. Herkese açıktır ve süresi dolmaz, ancak dosya silindiğinde çalışmayı durdurur. media.wbiztool.com (CDN'imiz) veya wbiztool-static.s3.ap-southeast-1.amazonaws.com üzerinde olabilir; ikisi de aynı dosyayı sunar, bu yüzden URL'yi olduğu gibi saklayın ve bu URL'leri kendiniz oluşturmayın.
data.file_typestringimage veya file.
data.file_sizeintegerBayt cinsinden boyut.
data.file_size_displaystringTek ondalıklı okunabilir boyut, örneğin 242.5 KB.
data.mime_typestringUzantıdan belirlenen MIME türü, örneğin application/pdf.
data.is_imagebooleanfile_type değeri image olduğunda true.
data.file_extensionstringoriginal_file_name değerinin noktasız, küçük harfli uzantısı.
data.created_atstringYükleme zamanı, +00:00 farkıyla UTC'de ISO 8601.

Hatalar#

Hatalar da status değeri 0 olarak HTTP 200 döndürür:

{ "status": 0, "message": "File is too large. Maximum size is 64MB. Your file: 71.3MB" }
MesajNasıl düzeltilir
Only POST method is supportedBir POST isteği gönderin.
client_id is requiredclient_id değerini form alanı olarak ekleyin. Gövdenin JSON değil, multipart/form-data olduğunu kontrol edin.
api_key is requiredapi_key değerini form alanı olarak ekleyin.
media_file is requiredDosyayı media_file adlı bir alanda gönderin.
client_id must be a valid integerclient_id değerini sayı olarak gönderin.
Invalid API keyAnahtarın mevcut olduğunu ve silinmediğini veya devre dışı bırakılmadığını kontrol edin.
Invalid client_id for this API keyAnahtar farklı bir client_id değerine ait.
File is too large. Maximum size is 64MB. Your file: …MB64 MB veya daha küçük bir dosya yükleyin.
File type not supported. Type detected: …Desteklenen uzantılardan birini kullanın.
Storage full: this workspace uses … of its … of media storage, and this file is …. Delete files you no longer need in the Media directory, or contact us if you need more space.Dosya, çalışma alanının medya depolama alanına sığmıyor. Artık ihtiyacınız olmayan dosyaları Medya klasörü sayfasında silin veya daha fazla alan için bizimle iletişime geçin.
Error uploading file: …Yükleme tamamlanamadı. Tekrar deneyin. API anahtarı bir çalışma alanına bağlı değilse de bunu alırsınız; kullanmak istediğiniz çalışma alanında yeni bir anahtar oluşturun.

Yükleme ve gönderme#

Dosyayı yükleyin, ardından file_url değerini Mesaj gönderme endpoint'ine iletin: görseller için msg_type 1 ile img_url olarak, diğer dosyalar için msg_type 2 ile file_url olarak.

Bir PDF yükleyip gönderme
import requests

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

with open("invoice-4821.pdf", "rb") as f:
    upload = requests.post(f"{BASE}/media/upload/", data=AUTH, files={"media_file": f}, timeout=120).json()
if upload["status"] != 1:
    raise SystemExit("Upload failed: " + upload["message"])

media = upload["data"]
message = {
    **AUTH,
    "whatsapp_client": 678,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Your invoice for order #4821 is attached.",
}
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"])

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

Bu API'nin kabul ettiği her dosya türü, msg_type 2 ile gönderildiğinde uzantısını korur, örneğin brochure.doc veya catalogue.zip. WAV ve OGG sesler çalınabilir ses olarak değil belge olarak ulaşır ve görsel olarak (msg_type 1) gönderildiğinde File type not supported ile başarısız olur. MP3, M4A ve AAC, sohbette çalan ses olarak ulaşır ve metin ayrı bir mesaj olarak gelir. Bkz. Görsel ve dosya gönderme. Ad küçük harflerle gönderilir (Invoice-4821.PDF, invoice-4821.pdf olarak ulaşır).

msg_type 1 ile gönderilen görseller 16 MB veya daha küçük olmalıdır. Daha büyük görseller burada sorunsuz yüklenir ama gönderilirken File exceeds WhatsApp size limit (16MB max) ile başarısız olur. Önce sıkıştırın veya msg_type 2 ile dosya olarak gönderin.

İpuçları#

  • Yüklemeleri yeniden kullanın. id veya file_url değerini saklayın ve aynı dosyayı yeniden yüklemek yerine birçok kez gönderin.
  • Orijinal adı anlamlı tutun. original_file_name panelde gördüğünüz addır ve gönderirken file_name için iyi bir değerdir.
  • Önceki yüklemeleri bulun: Medya listeleme ile bulun.