Dokumentasi REST API
Base URL: https://terapi.lamuri.biz.id · versi API 2.0.0.
Semua respons JSON berbentuk {ok:true,data} atau {ok:false,error}.
Alur pemakaian
Meta
Informasi layanan, konfigurasi publik, statistik, dan OpenAPI.
/api
meta
Indeks layanan
Mengembalikan nama layanan, versi, daftar endpoint, dan tautan dokumentasi. Berguna untuk discovery otomatis.
Tanpa parameter.
Mengembalikan: service, version, api_version, endpoints[], links{health,config,docs,openapi}
curl https://terapi.lamuri.biz.id/api
/api/health
meta
Status & mode
Cek kesehatan layanan dan apakah sesi akun TeraBox sedang valid. `mode` bernilai `full` hanya bila probe akun baru saja berhasil; `preview` berarti video dibatasi ~30 detik.
Tanpa parameter.
Mengembalikan: status, mode, account{configured,valid,pool,base}, uptime_ms, time
curl https://terapi.lamuri.biz.id/api/health
/api/config
meta
Konfigurasi publik
Nilai publik yang dibutuhkan klien: TTL token, batas halaman, jumlah batch, stream types, dan mode. Tidak pernah memuat cookie/secret.
Tanpa parameter.
Mengembalikan: token_ttl, token_bind_ip, max_page_size, max_batch, max_files, stream_types, mode, cors
curl https://terapi.lamuri.biz.id/api/config
/api/stats
meta
Statistik ringan
Penghitung per-isolate (bukan database): request, resolve, media, error, cache hit. Reset saat isolate didaur ulang.
Tanpa parameter.
Mengembalikan: starts_at, uptime_ms, counters{}
/api/openapi.json
meta
Spesifikasi OpenAPI 3.1
Dokumen OpenAPI lengkap; bisa di-import ke Postman/Insomnia/Swagger UI.
Tanpa parameter.
Mengembalikan: OpenAPI 3.1 document
File
Pagination, pencarian, detail file, dan tautan siap pakai.
/api/files
file
Daftar file (pagination + filter)
Mengambil halaman daftar file dari token yang sudah diterbitkan. Semua tipe file tersedia (video, gambar, audio, dokumen, arsip, other), lengkap dengan URL thumbnail/stream/download.
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
type |
query | string |
— | Filter tipe file. |
q |
query | string |
— | Pencarian nama/path. |
sort |
query | string |
— | name|size|duration|mtime|path. |
order |
query | string |
— | asc|desc. |
min_size |
query | integer |
— | Ukuran minimum (byte). |
max_size |
query | integer |
— | Ukuran maksimum (byte). |
has_thumb |
query | boolean |
— | Filter ada/tidaknya thumbnail. |
limit |
query | integer |
— | Jumlah item per halaman (1..200, default 50). contoh: 50 |
offset |
query | integer |
— | Offset mulai (default 0). contoh: 0 |
Mengembalikan: files[], page{total,limit,offset,has_more}, stats{}
curl "https://terapi.lamuri.biz.id/api/files?t=TOKEN&q=mp4&sort=size&order=desc&limit=50"
/api/file/{fid}
file
Detail satu file
Metadata lengkap satu file + tautan siap pakai: hls, stream, download, thumb, plus dlink TeraBox (informasional; sering 403 dari IP lain).
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
fid |
path | string |
wajib | fs_id file. contoh: 527531790422450 |
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
probe |
query | boolean |
— | true: ambil durasi & jumlah segmen sebenarnya dari playlist TeraBox (data `media`). |
dlink |
query | boolean |
— | true: ikut ambil dlink mentah (lebih lambat). |
Mengembalikan: file{}, links{hls,stream,download,thumb,dlink}, media{duration,segments,preview_only}?, stream_info{preview_only,mode,expires_at}
curl "https://terapi.lamuri.biz.id/api/file/527531790422450?t=TOKEN"
/api/link
file
Tautan siap pakai untuk satu file
Mengembalikan hls/stream/download/thumb yang sudah ditandatangani, plus `dlink` TeraBox mentah untuk diagnosa. Gunakan endpoint ini bila frontend tidak ingin menyusun URL sendiri.
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
f |
query | string |
wajib | fs_id file (angka) dari daftar file. contoh: 527531790422450 |
ty |
query | integer |
— | Indeks stream type (0..2, default 0). |
probe |
query | boolean |
— | true: isi `duration`/`segments` sebenarnya dari playlist (data `media`). |
dlink |
query | boolean |
— | Sertakan dlink mentah (default true). |
Mengembalikan: fs_id, name, size, duration, duration_human, segments, media?, hls, stream, download, thumb, dlink, preview_only, mode, expires_at
curl "https://terapi.lamuri.biz.id/api/link?t=TOKEN&f=527531790422450"
Media
HLS, segmen, stream Range, unduhan, dan thumbnail.
/api/hls
media
Playlist HLS (m3u8)
Mengembalikan playlist VOD yang seluruh segmennya sudah diproksi ke /api/seg. Bisa diputar dengan hls.js, ExoPlayer, VLC, ffmpeg. Header `x-preview-only` menandai mode pratinjau.
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
f |
query | string |
wajib | fs_id file (angka) dari daftar file. contoh: 527531790422450 |
ty |
query | integer |
— | Indeks stream type (0..2). |
Mengembalikan: text/plain m3u8 (bukan JSON)
curl "https://terapi.lamuri.biz.id/api/hls?t=TOKEN&f=527531790422450"
/api/seg
media
Segmen MPEG-TS
Memproksi satu segmen; mendukung Range dan otomatis menerbitkan ulang playlist jika URL segmen kedaluwarsa (401/403/410).
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
f |
query | string |
wajib | fs_id file (angka) dari daftar file. contoh: 527531790422450 |
ty |
query | integer |
— | Indeks stream type. |
i |
query | integer |
wajib | Indeks segmen (0-based). |
Mengembalikan: video/mp2t
curl -o seg0.ts "https://terapi.lamuri.biz.id/api/seg?t=TOKEN&f=FID&i=0"
/api/stream
media
Stream video/audio (inline, Range)
Proksi file asli dengan dukungan Range (206). Cocok untuk <video src>. Tanpa sesi akun, TeraBox dapat menolak (409 PREVIEW_ONLY / 410 TOKEN_EXPIRED).
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
f |
query | string |
wajib | fs_id file (angka) dari daftar file. contoh: 527531790422450 |
Mengembalikan: byte stream + Content-Length/Content-Range/Accept-Ranges
curl -I "https://terapi.lamuri.biz.id/api/stream?t=TOKEN&f=FID"
/api/download
media
Unduh file asli (attachment)
Sama seperti /api/stream tetapi dengan `Content-Disposition: attachment` dan nama file asli.
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
f |
query | string |
wajib | fs_id file (angka) dari daftar file. contoh: 527531790422450 |
Mengembalikan: byte stream + Content-Disposition
curl -L -o video.mp4 "https://terapi.lamuri.biz.id/api/download?t=TOKEN&f=FID"
/api/thumb
media
Thumbnail file
Proksi thumbnail TeraBox (cache 6 jam). Tambahkan `fallback=1` untuk selalu mendapat gambar SVG placeholder saat thumbnail tidak tersedia.
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
t |
query | string |
wajib | Token dari /api/resolve atau /api/share. Jangan diubah; berlaku sampai `expires_at`. contoh: tb1.xxxxx |
f |
query | string |
wajib | fs_id file (angka) dari daftar file. contoh: 527531790422450 |
fallback |
query | boolean |
— | 1/true: kirim placeholder SVG jika tidak ada thumbnail. |
Mengembalikan: image/* (atau SVG placeholder)
curl -o thumb.jpg "https://terapi.lamuri.biz.id/api/thumb?t=TOKEN&f=FID&fallback=1"
Kode error
| Kode | HTTP | Arti |
|---|---|---|
BAD_REQUEST | 400 | Body/parameter tidak lengkap atau formatnya salah. |
BAD_PARAM | 400 | Nilai parameter tidak valid (mis. fs_id bukan angka). |
INVALID_URL | 400 | Bukan link share TeraBox yang dikenali. |
METHOD_NOT_ALLOWED | 405 | HTTP method tidak didukung endpoint tersebut. |
PAYLOAD_TOO_LARGE | 413 | Body melebihi batas (default 16 KB). |
UNSUPPORTED_MEDIA_TYPE | 415 | Content-Type bukan JSON/form-urlencoded. |
FORBIDDEN | 403 | Akses ditolak (mis. endpoint admin tanpa token). |
API_KEY_REQUIRED | 401 | API_KEYS aktif dan header x-api-key tidak dikirim. |
API_KEY_INVALID | 403 | API key tidak ada di daftar. |
RATE_LIMITED | 429 | Terlalu banyak request; tunggu sesuai header Retry-After. |
TURNSTILE_FAILED | 403 | Verifikasi Turnstile gagal/kedaluwarsa. |
SHARE_NOT_FOUND | 404 | Share tidak ada, kedaluwarsa, atau dihapus. |
SHARE_GATED | 503 | TeraBox meminta verifikasi IP server; coba beberapa menit lagi. |
SHARE_EMPTY | 422 | Share valid tetapi tidak berisi file. |
PASSWORD_REQUIRED | 401 | Share dilindungi password (belum didukung). |
NO_VIDEOS | 422 | Tidak ada video di share tersebut. |
TOKEN_INVALID | 403 | Token rusak, palsu, atau terikat jaringan lain. |
TOKEN_EXPIRED | 410 | Token kedaluwarsa; panggil /api/resolve lagi. |
FILE_NOT_FOUND | 404 | fs_id tidak ada pada share/token tersebut. |
FILE_NOT_READY | 409 | TeraBox belum menyediakan playlist untuk file ini. |
PREVIEW_ONLY | 409 | Tanpa sesi akun, TeraBox hanya mengizinkan pratinjau ~30 detik. |
UPSTREAM_ERROR | 502 | TeraBox menolak/mengembalikan respons tak terduga. |
UPSTREAM_UNAVAILABLE | 502 | TeraBox tidak bisa dihubungi; boleh dicoba ulang. |
NOT_FOUND | 404 | Endpoint tidak dikenal. |
INTERNAL_ERROR | 500 | Kesalahan internal (mis. TOKEN_SECRET belum diset). |
Catatan data
- `duration` dan `mtime` berasal dari field upstream (bisa 0 bila TeraBox tidak mengirimnya).
- Daftar file TeraBox hampir selalu mengosongkan `duration`. Untuk durasi akurat, panggil `/api/link?...&probe=1` atau `GET /api/file/{fid}?probe=1` (data `media`); `/api/hls` juga mengirim header `x-video-duration` dan `x-segments`.
- `size` adalah ukuran byte asli; `size_human` hanya untuk tampilan.
- `thumb` selalu URL API ini (bukan URL TeraBox) agar tidak terkena hotlink/referer.
- `dlink` TeraBox terikat IP+sesi penerbit; mengaksesnya dari IP lain akan 403. Karena itu semua media lewat /api/stream.
- `stats.truncated` true berarti share lebih besar dari MAX_FILES; daftar tidak lengkap.
- Untuk share dengan ribuan file, cache daftar 15 menit; panggil ulang dengan `refresh:true` bila share berubah.
- Jangan probe durasi untuk ratusan file sekaligus — setiap probe adalah satu permintaan playlist ke TeraBox.