API Media
API Unggah media
Unggah file gambar, dokumen, audio, atau video ke Direktori media workspace Anda dan dapatkan URL unduhannya. Kirim URL tersebut ke Kirim pesan, atau ke Buat pengingat sebagai img_url, jika Anda tidak memiliki hosting file sendiri.
https://wbiztool.com/api/v1/media/upload/Body: multipart/form-data
File langsung disimpan dan respons menyertakan file_url-nya. File yang diunggah juga muncul di halaman Direktori media di dashboard Anda.
Contoh singkat#
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.pdfimport requests
with open("invoice-4821.pdf", "rb") as f:
response = requests.post(
"https://wbiztool.com/api/v1/media/upload/",
data={"client_id": 12345, "api_key": "YOUR_API_KEY"},
files={"media_file": f},
timeout=120,
)
try:
result = response.json()
except ValueError:
# A proxy can reject a very large upload with an HTML page before it reaches WbizTool.
raise SystemExit(f"HTTP {response.status_code}: not JSON. Check the file size.")
if result["status"] == 1:
print("Uploaded:", result["data"]["file_url"])
else:
print("Failed:", result["message"])// Node.js 20+ (built-in fetch, FormData and fs.openAsBlob). Save as .mjs to use top-level await.
import { openAsBlob } from "node:fs";
const form = new FormData();
form.append("client_id", "12345");
form.append("api_key", "YOUR_API_KEY");
form.append("media_file", await openAsBlob("./invoice-4821.pdf"), "invoice-4821.pdf");
// Don't set Content-Type yourself; fetch adds the multipart boundary.
const response = await fetch("https://wbiztool.com/api/v1/media/upload/", { method: "POST", body: form });
const result = await response.json();
if (result.status === 1) {
console.log("Uploaded:", result.data.file_url);
} else {
console.error("Failed:", result.message);
}<?php
$ch = curl_init('https://wbiztool.com/api/v1/media/upload/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
// An array body (not json_encode) makes cURL send multipart/form-data.
CURLOPT_POSTFIELDS => [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
'media_file' => new CURLFile('/path/to/invoice-4821.pdf', 'application/pdf', 'invoice-4821.pdf'),
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 120,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (($result['status'] ?? 0) === 1) {
echo 'Uploaded: ' . $result['data']['file_url'];
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}Ganti 12345 dan YOUR_API_KEY dengan nilai Anda sendiri. Lihat Autentikasi untuk mengetahui di mana menemukannya.
Parameter request#
Kirim request sebagai multipart/form-data. Body JSON dan parameter query string tidak dibaca oleh endpoint ini.
AuthorizationheaderDisarankanBearer YOUR_API_KEY: kunci API Anda dari Pengaturan → Kunci API. Dengan header ini,client_iddanapi_keyboleh tidak dikirim di body; jika keduanya dikirim, kunci valid di header yang dipakai. Lihat Mengirim kunci di header.client_idintegerTanpa header AuthorizationAPI Client ID Anda dari Pengaturan → Kunci API. Opsional jika memakai header; jika Anda mengirimnya, nilainya harus Client ID workspace kunci tersebut.
api_keystringTanpa header AuthorizationKunci API Anda dari halaman yang sama, jika Anda tidak mengirimnya di header.
media_filefilewajibFile yang akan diunggah, hingga 64 MB, dan harus muat di penyimpanan media workspace. Jenisnya ditentukan oleh ekstensi nama file, jadi nama harus diakhiri salah satu ekstensi yang didukung.
Jenis file yang didukung#
| Kategori | Ekstensi |
|---|---|
| Gambar | .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 |
| Arsip | .zip, .rar |
Gambar disimpan dengan file_type bernilai image; semua jenis lainnya bernilai file.
Penyimpanan per workspace#
Semua file di Direktori media sebuah workspace berbagi satu batas penyimpanan, yang ditentukan oleh paket workspace. File yang diunggah dengan API ini dan di halaman Direktori media sama-sama dihitung, dan menghapus file akan mengosongkan ruangnya.
| Paket | Penyimpanan media |
|---|---|
| Uji coba gratis | 250 MB |
| Lite | 1 GB |
| Standard | 2 GB |
| Advanced | 5 GB |
| Enterprise | 10 GB |
| AppSumo Plan 1 dan Plan 2 | 1 GB |
| AppSumo Plan 3 | 2 GB |
| AppSumo Plan 4 | 3 GB |
| AppSumo Plan 5 | 5 GB |
Paket lama, dan workspace tanpa paket aktif, mendapat 1 GB. Unggahan yang tidak muat ditolak dengan Storage full: … (lihat Error). Workspace yang sudah melebihi batasnya tetap menyimpan file-filenya, tetapi tidak dapat menambahkan file baru sampai ada ruang untuknya.
Respons#
Request yang berhasil mengembalikan 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"
}
}
| Field | Tipe | Deskripsi |
|---|---|---|
status | integer | 1 jika file berhasil diunggah, 0 jika request gagal. |
message | string | File uploaded successfully, selain itu berisi error. |
data.id | integer | ID file media. Gunakan dengan Ambil file media. |
data.file_name | string | Nama penyimpanan file, dibuat oleh WbizTool: media_, ID workspace Anda, waktu unggah, dan bagian acak, dengan ekstensi file. |
data.original_file_name | string | Nama file yang Anda unggah. |
data.file_url | string | URL unduhan langsung. Gunakan sebagai img_url atau file_url saat mengirim. URL ini publik dan tidak kedaluwarsa, tetapi berhenti berfungsi saat file dihapus. URL ini bisa berada di media.wbiztool.com (CDN kami) atau wbiztool-static.s3.ap-southeast-1.amazonaws.com; keduanya menyajikan file yang sama, jadi simpan URL apa adanya dan jangan menyusun URL ini sendiri. |
data.file_type | string | image atau file. |
data.file_size | integer | Ukuran dalam byte. |
data.file_size_display | string | Ukuran yang mudah dibaca dengan satu desimal, misalnya 242.5 KB. |
data.mime_type | string | Tipe MIME yang ditentukan dari ekstensi, misalnya application/pdf. |
data.is_image | boolean | true jika file_type bernilai image. |
data.file_extension | string | Ekstensi original_file_name dalam huruf kecil, tanpa titik. |
data.created_at | string | Waktu unggah, ISO 8601 dalam UTC dengan offset +00:00. |
Error#
Error juga mengembalikan HTTP 200, dengan status bernilai 0:
{ "status": 0, "message": "File is too large. Maximum size is 64MB. Your file: 71.3MB" }
| Pesan | Cara memperbaikinya |
|---|---|
Only POST method is supported | Kirim request POST. |
client_id is required | Tambahkan client_id sebagai field formulir. Pastikan body berupa multipart/form-data, bukan JSON. |
api_key is required | Tambahkan api_key sebagai field formulir. |
media_file is required | Kirim file di field bernama media_file. |
client_id must be a valid integer | Kirim client_id sebagai angka. |
Invalid API key | Pastikan kunci tersebut ada dan belum dihapus atau dinonaktifkan. |
Invalid client_id for this API key | Kunci tersebut milik client_id lain. |
File is too large. Maximum size is 64MB. Your file: …MB | Unggah file berukuran 64 MB atau kurang. |
File type not supported. Type detected: … | Gunakan salah satu ekstensi yang didukung. |
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. | File tidak muat di penyimpanan media workspace. Hapus file yang tidak lagi diperlukan di halaman Direktori media, atau hubungi kami untuk mendapatkan ruang lebih. |
Error uploading file: … | Unggahan tidak dapat diselesaikan. Coba lagi. Anda juga mendapatkan error ini jika kunci API tidak terhubung ke workspace; buat kunci baru di workspace yang ingin Anda gunakan. |
Unggah lalu kirim#
Unggah file, lalu kirim file_url ke Kirim pesan: sebagai img_url dengan msg_type 1 untuk gambar, atau sebagai file_url dengan msg_type 2 untuk file lainnya.
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)// Node.js 20+ (built-in fetch, FormData and fs.openAsBlob). Save as .mjs to use top-level await.
import { openAsBlob } from "node:fs";
const BASE = "https://wbiztool.com/api/v1";
const form = new FormData();
form.append("client_id", "12345");
form.append("api_key", "YOUR_API_KEY");
form.append("media_file", await openAsBlob("./invoice-4821.pdf"), "invoice-4821.pdf");
const upload = await (await fetch(`${BASE}/media/upload/`, { method: "POST", body: form })).json();
if (upload.status !== 1) throw new Error(`Upload failed: ${upload.message}`);
const media = upload.data;
const message = {
client_id: 12345,
api_key: "YOUR_API_KEY",
whatsapp_client: 678,
country_code: "91",
phone: "9876543210",
msg: "Your invoice for order #4821 is attached.",
...(media.is_image
? { msg_type: 1, img_url: media.file_url }
: { msg_type: 2, file_url: media.file_url, file_name: media.original_file_name }),
};
const sent = await fetch(`${BASE}/send_msg/`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(message),
});
console.log(await sent.json());Setiap jenis file yang diterima API ini mempertahankan ekstensinya saat dikirim dengan msg_type 2, misalnya brochure.doc atau catalogue.zip. Audio WAV dan OGG diterima sebagai dokumen, bukan audio yang dapat diputar, dan gagal dengan File type not supported jika dikirim sebagai gambar (msg_type 1). MP3, M4A, dan AAC diterima sebagai audio yang dapat diputar di chat, dengan teksnya sebagai pesan terpisah. Lihat Mengirim gambar dan file. Nama dikirim dalam huruf kecil (Invoice-4821.PDF diterima sebagai invoice-4821.pdf).
Gambar yang dikirim dengan msg_type 1 harus berukuran 16 MB atau lebih kecil. Gambar yang lebih besar berhasil diunggah di sini, tetapi gagal saat dikirim dengan File exceeds WhatsApp size limit (16MB max). Kompres terlebih dahulu, atau kirim sebagai file dengan msg_type 2.
Tips#
- Gunakan ulang unggahan. Simpan
idataufile_urldan kirim file yang sama berkali-kali, alih-alih mengunggahnya lagi. - Gunakan nama asli yang bermakna.
original_file_nameadalah nama yang Anda lihat di dashboard dan nilai yang baik untukfile_namesaat mengirim. - Temukan unggahan sebelumnya dengan Daftar media.

