Langkau ke kandungan
WbizTool

API media

API Muat Naik Media

Muat naik fail imej, dokumen, audio atau video ke Direktori media ruang kerja anda dan dapatkan semula URL muat turun. Hantar URL itu kepada Hantar mesej, atau kepada Cipta peringatan sebagai img_url, apabila anda tiada pengehosan fail sendiri.

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

Body: multipart/form-data

Fail disimpan serta-merta dan respons menyertakan file_urlnya. Fail yang dimuat naik juga muncul di halaman Direktori media dalam papan pemuka anda.

Contoh ringkas#

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

Gantikan 12345 dan YOUR_API_KEY dengan nilai anda sendiri. Lihat Pengesahan identiti untuk mengetahui di mana nilai ini boleh didapati.

Parameter permintaan#

Hantar permintaan sebagai multipart/form-data. Badan JSON dan parameter rentetan pertanyaan tidak dibaca oleh endpoint ini.

AuthorizationheaderDisyorkan

Bearer YOUR_API_KEY: kunci API anda dari Tetapan → Kunci API. Dengan pengepala ini, client_id dan api_key boleh ditinggalkan daripada badan; jika kedua-duanya dihantar, kunci sah dalam pengepala yang digunakan. Lihat Hantar kunci dalam pengepala.

client_idintegerTanpa pengepala Authorization

API Client ID anda dari Tetapan → Kunci API. Pilihan dengan pengepala; jika anda menghantarnya, ia mestilah Client ID ruang kerja kunci itu.

api_keystringTanpa pengepala Authorization

Kunci API anda dari halaman yang sama, apabila anda tidak menghantarnya dalam pengepala.

media_filefilewajib

Fail yang hendak dimuat naik, sehingga 64 MB, dan ia mesti muat dalam storan media ruang kerja. Jenisnya ditentukan oleh sambungan nama fail, jadi nama mesti berakhir dengan salah satu sambungan yang disokong.

Jenis fail yang disokong#

KategoriSambungan
Imej.jpg, .jpeg, .png, .gif, .webp, .bmp
Dokumen.pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .txt, .csv
Audio.mp3, .m4a, .wav, .ogg, .aac
Video.mp4, .mov, .avi
Arkib.zip, .rar

Imej disimpan dengan file_type ditetapkan kepada image; selainnya ialah file.

Storan setiap ruang kerja#

Semua fail dalam Direktori media sesebuah ruang kerja berkongsi satu had storan, yang ditetapkan oleh pelan ruang kerja itu. Fail yang dimuat naik dengan API ini dan di halaman Direktori media kedua-duanya dikira, dan memadam fail membebaskan ruangnya.

PelanStoran media
Percubaan percuma250 MB
Lite1 GB
Standard2 GB
Advanced5 GB
Enterprise10 GB
AppSumo Plan 1 dan Plan 21 GB
AppSumo Plan 32 GB
AppSumo Plan 43 GB
AppSumo Plan 55 GB

Pelan lama, dan ruang kerja tanpa pelan aktif, mempunyai 1 GB. Muat naik yang tidak muat ditolak dengan Storage full: … (lihat Ralat). Ruang kerja yang sudah melebihi hadnya mengekalkan failnya, tetapi tidak boleh menambah fail baharu sehingga ada ruang untuknya.

Respons#

Permintaan yang berjaya memulangkan HTTP 200:

{
  "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"
  }
}
MedanJenisPenerangan
statusinteger1 jika fail telah dimuat naik, 0 jika permintaan gagal.
messagestringFile uploaded successfully, jika tidak, mesej ralat.
data.idintegerID fail media. Gunakannya dengan Dapatkan fail media.
data.file_namestringNama simpanan fail, dijana oleh WbizTool: media_, ID ruang kerja anda, masa muat naik dan bahagian rawak, dengan sambungan fail itu.
data.original_file_namestringNama fail yang anda muat naik.
data.file_urlstringURL muat turun terus. Gunakannya sebagai img_url atau file_url semasa menghantar. Ia awam dan tidak tamat tempoh, tetapi berhenti berfungsi apabila fail dipadam. Ia mungkin berada di media.wbiztool.com (CDN kami) atau wbiztool-static.s3.ap-southeast-1.amazonaws.com; kedua-duanya menyajikan fail yang sama, jadi simpan URL itu seadanya dan jangan bina URL ini sendiri.
data.file_typestringimage atau file.
data.file_sizeintegerSaiz dalam bait.
data.file_size_displaystringSaiz yang mudah dibaca dengan satu tempat perpuluhan, contohnya 242.5 KB.
data.mime_typestringJenis MIME yang ditentukan daripada sambungan, contohnya application/pdf.
data.is_imagebooleantrue apabila file_type ialah image.
data.file_extensionstringSambungan huruf kecil bagi original_file_name, tanpa titik.
data.created_atstringMasa muat naik, ISO 8601 dalam UTC dengan ofset +00:00.

Ralat#

Ralat juga memulangkan HTTP 200, dengan status ditetapkan kepada 0:

{ "status": 0, "message": "File is too large. Maximum size is 64MB. Your file: 71.3MB" }
MesejCara membetulkannya
Only POST method is supportedHantar permintaan POST.
client_id is requiredTambah client_id sebagai medan borang. Pastikan badan permintaan ialah multipart/form-data, bukan JSON.
api_key is requiredTambah api_key sebagai medan borang.
media_file is requiredHantar fail dalam medan bernama media_file.
client_id must be a valid integerHantar client_id sebagai nombor.
Invalid API keyPastikan kunci wujud dan belum dipadam atau dinyahdayakan.
Invalid client_id for this API keyKunci itu milik client_id yang lain.
File is too large. Maximum size is 64MB. Your file: …MBMuat naik fail bersaiz 64 MB atau kurang.
File type not supported. Type detected: …Gunakan salah satu sambungan yang disokong.
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.Fail tidak muat dalam storan media ruang kerja. Padam fail yang tidak diperlukan lagi di halaman Direktori media, atau hubungi kami untuk ruang tambahan.
Error uploading file: …Muat naik tidak dapat diselesaikan. Cuba lagi. Anda juga menerima ralat ini jika kunci API tidak dipautkan ke mana-mana ruang kerja; cipta kunci baharu dalam ruang kerja yang anda mahu gunakan.

Muat naik dan hantar#

Muat naik fail, kemudian hantar file_url kepada Hantar mesej: sebagai img_url dengan msg_type 1 untuk imej, atau sebagai file_url dengan msg_type 2 untuk fail lain.

Muat naik PDF dan hantarkannya
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)

Setiap jenis fail yang diterima oleh API ini mengekalkan sambungannya apabila dihantar dengan msg_type 2, contohnya brochure.doc atau catalogue.zip. Audio WAV dan OGG diterima sebagai dokumen, bukan audio yang boleh dimainkan, dan gagal dengan File type not supported apabila dihantar sebagai imej (msg_type 1). MP3, M4A dan AAC diterima sebagai audio yang dimainkan dalam sembang, dengan teks sebagai mesej berasingan. Lihat Menghantar imej dan fail. Nama dihantar dalam huruf kecil (Invoice-4821.PDF diterima sebagai invoice-4821.pdf).

Imej yang dihantar dengan msg_type 1 mesti bersaiz 16 MB atau kurang. Imej yang lebih besar boleh dimuat naik di sini tetapi gagal semasa dihantar, dengan File exceeds WhatsApp size limit (16MB max). Mampatkan imej dahulu, atau hantarkannya sebagai fail dengan msg_type 2.

Petua#

  • Guna semula muat naik. Simpan id atau file_url dan hantar fail yang sama berkali-kali dan bukannya memuat naiknya semula.
  • Pastikan nama asal bermakna. original_file_name ialah nama yang anda lihat dalam papan pemuka dan nilai yang baik untuk file_name semasa menghantar.
  • Cari muat naik terdahulu dengan Senarai media.