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

1
Resolve share
POST /api/resolve {"url":"<link>"} → dapat `token` + `files[]` + `stats`.
2
Pilih file
Gunakan `fs_id` dari files[]. Filter dengan `type`, cari dengan `q`, halaman dengan `limit/offset`.
3
Putar (HLS)
Pakai `files[].hls` di hls.js/Video.js. Playlist sudah diproksi; jangan pakai dlink mentah.
4
Unduh
Arahkan pengguna ke `files[].download` (attachment, mendukung Range/resume).
5
Tangani mode
Cek `preview_only`/`mode`. `full` = durasi penuh. `preview` = TeraBox membatasi ~30 detik karena server tidak punya sesi akun valid.

Meta

Informasi layanan, konfigurasi publik, statistik, dan OpenAPI.

GET /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
GET /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
GET /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
GET /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{}

GET /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

Share & resolve

Endpoint utama untuk mengubah link menjadi data file + token.

GET /api/share share API key opsional

Info share + daftar file (GET)

Membaca share link lalu mengembalikan metadata (judul, jumlah file, total ukuran, statistik per tipe) beserta satu halaman daftar file. Token yang dikembalikan dipakai untuk endpoint media.

NamaLokasiTipeWajibKeterangan
url query string — Share link lengkap ATAU surl pendek. contoh: https://www.terabox.com/s/17pp0ENOmlfSqhijcdEFsug
surl query string — Alternatif: surl saja (tanpa https://). contoh: 7pp0ENOmlfSqhijcdEFsug
type query string — Filter tipe: all|video|image|audio|document|archive|other. contoh: video
q query string — Cari pada nama/path (case-insensitive).
sort query string — name|size|duration|mtime|path (default name).
order query string — asc|desc (default asc).
has_thumb query boolean — true/false untuk memfilter file yang punya thumbnail.
bind_ip query boolean — Ikat token ke IP pemanggil (default ikut konfigurasi server).
limit query integer — Jumlah item per halaman (1..200, default 50). contoh: 50
offset query integer — Offset mulai (default 0). contoh: 0

Mengembalikan: surl, title, token, expires_at, mode, stats{}, files[], page{}

curl "https://terapi.lamuri.biz.id/api/share?url=https://www.terabox.com/s/17pp0ENOmlfSqhijcdEFsug&limit=20&type=video"
POST /api/share share API key opsional

Info share + daftar file (POST)

Sama dengan GET /api/share, tetapi input lewat body JSON (lebih aman untuk link panjang).

NamaLokasiTipeWajibKeterangan
url body string wajib Share link atau surl. contoh: https://www.terabox.com/s/17pp0ENOmlfSqhijcdEFsug
type body string — Filter tipe file.
q body string — Kata kunci pencarian.
sort body string — name|size|duration|mtime|path.
order body string — asc|desc.
limit body integer — 1..200 (default 50).
offset body integer — Default 0.
bind_ip body boolean — Ikat token ke IP.

Mengembalikan: idem GET /api/share

curl -X POST https://terapi.lamuri.biz.id/api/share -H 'content-type: application/json' -d '{"url":"https://www.terabox.com/s/17pp0ENOmlfSqhijcdEFsug","limit":10}'
GET /api/resolve share API key opsional

Resolve share (GET)

Alias ringkas GET /api/share. Semua parameter sama.

NamaLokasiTipeWajibKeterangan
url query string — Share link atau surl.
limit query integer — Jumlah item per halaman (1..200, default 50). contoh: 50
offset query integer — Offset mulai (default 0). contoh: 0

Mengembalikan: idem GET /api/share

curl "https://terapi.lamuri.biz.id/api/resolve?url=7pp0ENOmlfSqhijcdEFsug"
POST /api/resolve share API key opsional

Resolve share (POST)

Endpoint utama untuk situs downloader. Kirim `{url, limit, offset, type, q, sort, order, bind_ip}`. Mengembalikan token sesi + daftar file + statistik.

NamaLokasiTipeWajibKeterangan
url body string wajib Share link TeraBox/1024tera atau surl.
limit body integer — Item per halaman (default 50).
offset body integer — Default 0.
type body string — Filter tipe.
q body string — Pencarian.
sort body string — name|size|duration|mtime|path.
order body string — asc|desc.
bind_ip body boolean — Ikat token ke IP (default config).
refresh body boolean — Paksa baca ulang daftar dari TeraBox (abaikan cache).

Mengembalikan: idem GET /api/share

curl -X POST https://terapi.lamuri.biz.id/api/resolve -H 'content-type: application/json' -d '{"url":"https://www.terabox.com/s/17pp0ENOmlfSqhijcdEFsug"}'
POST /api/resolve/batch share API key opsional

Resolve banyak share sekaligus

Maksimum `MAX_BATCH` (default 10) URL per panggilan. Setiap entri mengembalikan sukses/gagal sendiri sehingga satu link mati tidak menggagalkan semuanya.

NamaLokasiTipeWajibKeterangan
urls body string[] wajib Array link share (maks. MAX_BATCH).
limit body integer — Item per share (default 20).
bind_ip body boolean — Ikat token ke IP.

Mengembalikan: results[{ok,url,surl?,data?,error?}], summary{total,ok,failed}

curl -X POST https://terapi.lamuri.biz.id/api/resolve/batch -H 'content-type: application/json' -d '{"urls":["https://www.terabox.com/s/17pp0ENOmlfSqhijcdEFsug"]}'

File

Pagination, pencarian, detail file, dan tautan siap pakai.

GET /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.

NamaLokasiTipeWajibKeterangan
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"
GET /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).

NamaLokasiTipeWajibKeterangan
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"

Media

HLS, segmen, stream Range, unduhan, dan thumbnail.

GET /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.

NamaLokasiTipeWajibKeterangan
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"
GET /api/seg media

Segmen MPEG-TS

Memproksi satu segmen; mendukung Range dan otomatis menerbitkan ulang playlist jika URL segmen kedaluwarsa (401/403/410).

NamaLokasiTipeWajibKeterangan
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"
GET /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).

NamaLokasiTipeWajibKeterangan
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"
GET /api/download media

Unduh file asli (attachment)

Sama seperti /api/stream tetapi dengan `Content-Disposition: attachment` dan nama file asli.

NamaLokasiTipeWajibKeterangan
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"
GET /api/thumb media

Thumbnail file

Proksi thumbnail TeraBox (cache 6 jam). Tambahkan `fallback=1` untuk selalu mendapat gambar SVG placeholder saat thumbnail tidak tersedia.

NamaLokasiTipeWajibKeterangan
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

KodeHTTPArti
BAD_REQUEST400Body/parameter tidak lengkap atau formatnya salah.
BAD_PARAM400Nilai parameter tidak valid (mis. fs_id bukan angka).
INVALID_URL400Bukan link share TeraBox yang dikenali.
METHOD_NOT_ALLOWED405HTTP method tidak didukung endpoint tersebut.
PAYLOAD_TOO_LARGE413Body melebihi batas (default 16 KB).
UNSUPPORTED_MEDIA_TYPE415Content-Type bukan JSON/form-urlencoded.
FORBIDDEN403Akses ditolak (mis. endpoint admin tanpa token).
API_KEY_REQUIRED401API_KEYS aktif dan header x-api-key tidak dikirim.
API_KEY_INVALID403API key tidak ada di daftar.
RATE_LIMITED429Terlalu banyak request; tunggu sesuai header Retry-After.
TURNSTILE_FAILED403Verifikasi Turnstile gagal/kedaluwarsa.
SHARE_NOT_FOUND404Share tidak ada, kedaluwarsa, atau dihapus.
SHARE_GATED503TeraBox meminta verifikasi IP server; coba beberapa menit lagi.
SHARE_EMPTY422Share valid tetapi tidak berisi file.
PASSWORD_REQUIRED401Share dilindungi password (belum didukung).
NO_VIDEOS422Tidak ada video di share tersebut.
TOKEN_INVALID403Token rusak, palsu, atau terikat jaringan lain.
TOKEN_EXPIRED410Token kedaluwarsa; panggil /api/resolve lagi.
FILE_NOT_FOUND404fs_id tidak ada pada share/token tersebut.
FILE_NOT_READY409TeraBox belum menyediakan playlist untuk file ini.
PREVIEW_ONLY409Tanpa sesi akun, TeraBox hanya mengizinkan pratinjau ~30 detik.
UPSTREAM_ERROR502TeraBox menolak/mengembalikan respons tak terduga.
UPSTREAM_UNAVAILABLE502TeraBox tidak bisa dihubungi; boleh dicoba ulang.
NOT_FOUND404Endpoint tidak dikenal.
INTERNAL_ERROR500Kesalahan 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.