Langkau ke kandungan
Wbiztool

API media

API Dapatkan Fail Media

Dapatkan butiran dan URL muat turun satu fail dalam pustaka media anda mengikut ID-nya. Gunakannya untuk menyemak bahawa fail masih wujud sebelum anda menghantarnya.

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

Body: Rentetan pertanyaan, atau badan JSON dengan POST

Gantikan {media_id} dalam laluan dengan id yang dipulangkan oleh Muat naik media atau Senarai media, contohnya /api/v1/media/5122/.

Contoh ringkas#

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

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

Parameter permintaan#

Hantar client_id dan api_key dalam rentetan pertanyaan permintaan GET, atau sebagai badan JSON dalam permintaan POST. Jika client_id berada dalam rentetan pertanyaan, badan JSON diabaikan.

Laluan

media_idintegerwajib

ID fail media. Ia mesti nombor bulat; selain itu, respons ialah halaman HTML „halaman tidak ditemui” dan bukannya JSON.

Pengesahan identiti

client_idintegerwajib

API Client ID anda dari Settings → API keys (Tetapan → Kunci API).

api_keystringwajib

Kunci API anda dari halaman yang sama.

Respons#

{
  "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]"
  }
}
MedanJenisPenerangan
statusinteger1 jika berjaya, 0 jika permintaan gagal.
messagestringMedia file retrieved successfully, jika tidak, mesej ralat.
data.idintegerID fail media.
data.file_namestringNama simpanan fail.
data.original_file_namestringNama fail semasa ia dimuat naik.
data.file_urlstringURL muat turun terus. Gunakannya sebagai img_url atau file_url semasa menghantar.
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, 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.
data.modified_atstringMasa rekod fail terakhir diubah, dalam format yang sama.
data.uploaded_bystring atau nullNama pengguna log masuk (biasanya alamat e-mel) ahli pasukan yang memuat naik fail.

Ralat#

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

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

Satu pengecualian: jika media_id bukan nombor, URL tidak sepadan dengan mana-mana endpoint dan anda akan menerima halaman HTML 404 dan bukannya JSON.

MesejCara membetulkannya
client_id is requiredTambah client_id.
api_key is requiredTambah api_key.
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.
Media file not foundTiada fail dengan ID ini dalam ruang kerja kunci API, atau fail itu telah dipadam.
Error retrieving media file: …Berlaku masalah di pihak kami. Cuba lagi.

Semak fail sebelum menghantarnya#

Dapatkan fail mengikut ID, berhenti jika ia tidak lagi wujud, kemudian hantar file_urlnya: sebagai img_url dengan msg_type 1 untuk imej, atau sebagai file_url dengan msg_type 2 untuk selainnya.

Hantar fail media yang disimpan
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())

Fail bukan imej seperti .doc, .ppt, .csv, .zip, .wav dan .mov diterima dengan .pdf ditambah pada nama, dan imej melebihi 16 MB gagal dihantar. Lihat Muat naik media → Muat naik dan hantar.

Petua#

  • Fail yang dipadam memulangkan Media file not found, walaupun file_urlnya mungkin masih boleh dimuat turun. Semak dengan endpoint ini dan bukannya dengan mengambil URL. URL fail yang dimuat naik adalah awam dan kekal; lihat Muat naik media → Muat naik dan hantar.
  • Fail adalah mengikut ruang kerja. Fail yang dimuat naik dalam satu ruang kerja tidak boleh dibaca dengan kunci API dari ruang kerja lain.
  • Tidak tahu ID-nya? Cari mengikut nama dengan Senarai media.