Panduan
Lengkap
Semua informasi yang kamu butuhkan — cara pakai, endpoint, limit, update, dan FAQ. Satu halaman, semuanya ada.
Bayangkan kamu di restoran. Kamu = aplikasi kamu. Pelayan = Zexxo API. Dapur = server Zexxo.
Kamu pesan sesuatu (kirim request) → Zexxo proses → Zexxo antar hasilnya ke kamu (response JSON).
Contoh: kamu minta download video TikTok → Zexxo proses → Zexxo kasih link download-nya ke kamu. Simpel!
zxxo_abc123... — tidak akan berubah selamanya.API Key dikirim di header setiap request. Ini seperti "kartu tanda pengenal" — tanpa ini, request ditolak.
fetch('/api/download/ytmp3?url=...', {
headers: { 'X-Api-Key': 'zxxo_xxx' }
});
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-Api-Key: zxxo_xxx'
]);
headers = { 'X-Api-Key': 'zxxo_xxx' }
requests.get(url, headers=headers)
curl 'https://zexxo-api.vercel.app/api/...' \ -H 'X-Api-Key: zxxo_xxx'
Zexxo sudah support CORS — bisa fetch langsung dari browser tanpa backend tambahan atau proxy!
Ini contoh lengkap cara pakai Zexxo di bot WhatsApp Baileys untuk download video TikTok:
import axios from 'axios';
const ZEXXO_KEY = 'APIKEY_KAMU'; // ganti ini!
let handler = async (m, { args, usedPrefix, command }) => {
const url = args[0];
if (!url) return m.reply(
'❌ Kirim link TikTok dulu!\n' +
'Contoh: ' + usedPrefix + command + ' https://vt.tiktok.com/xxx'
);
await m.reply('⏳ Mengunduh video TikTok...');
try {
const { data } = await axios.get(
'https://zexxo-api.vercel.app/api/download/tiktok',
{
params: { url },
headers: { 'X-Api-Key': ZEXXO_KEY }
}
);
if (data.status !== 200) throw new Error(data.message);
const result = data.data;
// Kirim video ke chat
await conn.sendMessage(m.chat, {
video: { url: result.download },
caption: `🎵 ${result.title || 'TikTok Video'}`
}, { quoted: m });
} catch (err) {
await m.reply('❌ Error: ' + err.message);
}
};
handler.help = ['ttdl '];
handler.tags = ['downloader'];
handler.command = ['ttdl', 'tiktok'];
export default handler;
| Aturan | Nilai | Keterangan |
|---|---|---|
| Rate Limit Global | 60 req/menit | Per IP address |
| Max Body Size | 10 MB | Untuk request POST |
| Timeout Upstream | 15–60 detik | Tergantung endpoint |
| AI Chat Timeout | 60 detik | Khusus DeepSeek & AI Free |
Jika melewati rate limit, kamu akan mendapat error 429 RATE_LIMITED. Tunggu 1 menit lalu coba lagi.
| Fitur | Status |
|---|---|
| Daftar Akun | ✓ Gratis |
| Semua Endpoint | ✓ Terbuka |
| API Key | ✓ Gratis |
| Tidak Ada Kuota Harian | ✓ Ya |
| Bayar Per Endpoint | ✗ Tidak |
Login ulang dengan akun Google yang sama. API Key akan otomatis ditampilkan kembali di halaman Profile — kamu tidak perlu mendaftar ulang.
Error 502 artinya sumber data (upstream) sedang bermasalah, bukan dari Zexxo. Biasanya terjadi karena API pihak ketiga down, atau konten yang dicari sudah tidak tersedia. Coba lagi beberapa menit kemudian.
Ya, semua endpoint Zexxo bisa diintegrasikan ke bot WhatsApp, Telegram, Discord, atau aplikasi apapun yang bisa melakukan HTTP request. Cukup sertakan API Key di header setiap request.
const API_KEY = 'zxxo_xxxxxxxxxx';
async function downloadYT(url) {
const res = await fetch(
`https://zexxo.vercel.app/api/download/ytmp3?url=${encodeURIComponent(url)}`,
{ headers: { 'X-Api-Key': API_KEY } }
);
// res langsung berisi file audio MP3
const buffer = Buffer.from(await res.arrayBuffer());
return buffer;
}
| Endpoint | Return |
|---|---|
| ytmp4, ytmp3 | Binary (video/audio file) |
| fakecall, fakedev, flaming | Binary (image/png) |
| fakegroup, fakegroupv2, fakewa | Binary (image/png) |
| mlbuild (dengan id) | Binary (image/png) |
| Semua lainnya | JSON |
Buka halaman Profile, lalu klik tombol Revoke Key. Setelah di-revoke, kamu bisa login ulang untuk mendapatkan key baru. Catatan: semua request dengan key lama akan gagal setelah di-revoke.
DELETE /api/revoke-key X-Api-Key: zxxo_xxxxxxxxxxxxxxxxxxxxxxxx
Setiap response error dari Zexxo API mengikuti format standar berikut:
{
"status": 400,
"error": "INVALID_INPUT",
"message": "Penjelasan detail kenapa error."
}200 OK
Request berhasil
Response normal berisi data yang diminta. Field data berisi hasil.
201 CREATED
Data berhasil dibuat
Khusus endpoint POST yang membuat resource baru, contoh: POST /api/snippet.
400 INVALID_INPUT
Parameter tidak valid
Parameter wajib kosong, format salah, atau value di luar range yang diizinkan. Cek message untuk tahu parameter mana yang bermasalah.
Contoh: URL kosong, scale di luar 1|4|8|16, UID hanya 5 digit, dll.
400 TOO_LARGE
Data terlalu besar
Input melebihi batas maksimum. Contoh: snippet melebihi 50.000 karakter.
400 ALREADY_OWNER
Sudah owner
Mencoba membeli owner padahal sudah berstatus owner.
401 AUTH_FAILED
Firebase token tidak valid
Token Firebase sudah expired atau tidak valid. Login ulang untuk mendapat token baru.
403 INVALID_KEY
API Key tidak valid / di-revoke
API key tidak ditemukan di database atau sudah di-revoke. Pastikan mengirim header x-api-key: zxxo_xxxxx dengan benar.
403 FORBIDDEN
Tidak punya izin
Endpoint memerlukan role yang lebih tinggi (owner / superowner). Tidak bisa akses fitur admin dengan akun user biasa.
404 NOT_FOUND
Data tidak ditemukan
Resource yang dicari tidak ada. Contoh: snippet ID salah, profil GitHub tidak ada, UID Genshin tidak publik, file MediaFire dihapus.
429 RATE_LIMITED
Terlalu banyak request
Melebihi batas 60 request/menit per IP. Tunggu 1 menit lalu coba lagi. Tanpa API key hanya dapat 5 request/hari.
429 FREE_LIMIT
Batas gratis habis
Request tanpa API key sudah mencapai batas 5x per hari. Login dan gunakan API key untuk akses unlimited.
500 INTERNAL_ERROR
Error internal server
Terjadi exception tak terduga di server. Biasanya karena upstream berubah format response atau network timeout. Coba lagi beberapa saat.
502 UPSTREAM_ERROR
Sumber data error
Layanan pihak ketiga yang digunakan (YouTube, Pinterest, HuggingFace, dll) mengembalikan error atau sedang down. Biasanya sementara — coba lagi 5–10 menit kemudian.
Ini bukan berarti API Zexxo mati, hanya sumber datanya yang bermasalah.
502 PARSE_ERROR
Gagal parse response
Response dari sumber data tidak bisa di-parse (format berubah atau tidak sesuai ekspektasi). Laporkan ke developer.
503 PAYMENT_UNAVAILABLE
Sistem pembayaran tidak aktif
Fitur beli owner via QRIS belum dikonfigurasi di server. Hubungi admin.
504 TIMEOUT
Proses terlalu lama
Endpoint dengan proses panjang (image upscale AI, image edit AI) melebihi batas waktu maksimum. Server upstream terlalu sibuk. Coba lagi beberapa menit kemudian.
Endpoint yang rentan timeout: /api/tools/imgupscale, /api/maker/editimg
- → Selalu cek field
messagedi response untuk penjelasan spesifik - → Error 4xx = diperbaiki dari sisi kamu (parameter, key, permission)
- → Error 5xx = tunggu dan coba lagi, bukan salah kamu
- → Error 502 paling sering terjadi pada endpoint yang scrape website pihak ketiga
- → Gunakan
/api/healthuntuk cek apakah server Zexxo online