Unggah Video API
Fungsi Uploads API menyediakan cara untuk mengunggah file video secara langsung dan memantau status pengolahan mereka.
Semua unggahan diproses secara asinkron. Anda akan menerima respons 202 Diterima segera, dan video akan diproses di latar belakang. Anda harus menggunakan endpoint status untuk memantau kemajuan.
Unggah Video
Endpoint ini menerima permintaan multipart/form-data untuk mengunggah file video baru.
POST /uploads
Badan Permintaan (multipart/form-data)
| Bidang | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
video | file | Ya | File video yang akan diunggah. |
folder | string | Ya | Jalur koleksi tempat video harus ditempatkan (misalnya, root/my-folder). |
Contoh Permintaan (.http)
POST /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-here
Content-Type: multipart/form-data; boundary=...
... (data formulir dengan file dan folder) ...Respons: 202 Diterima
Respons API mengakui unggahan dan kembali status awal. Anda harus menyimpan id untuk memeriksa status kemudian.
{
"message": "Unggahan diterima dan sedang diproses.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "menunggu"
}
}Dapatkan Status Unggahan
Mengambil status unggahan terbaru 50. Anda dapat memantau endpoint ini untuk memperbarui UI.
GET /uploads
Contoh Permintaan
GET /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-hereRespons: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "my_new_video.mp4",
"status": 3,
"status_text": "proses",
"created_at": "2024-08-11T10:00:00Z",
"updated_at": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filename": "my_previous_video.mp4",
"status": 6,
"status_text": "selesai",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Dapatkan Status Unggahan Tunggal
Mengambil status video tertentu berdasarkan ID.
GET /uploads/{videoId}
Contoh Permintaan
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fRespons: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "my_new_video.mp4",
"status": 6,
"status_text": "selesai"
}
}Referensi Status
| Kode Status | Tekst Status | Deskripsi |
|---|---|---|
1 | menunggu | Unggahan diproses secara berurutan dan menunggu untuk diproses. |
3 | proses | Video sedang dienkripsi. |
5 | mengunggah | File yang telah dienkripsi sedang diunggah ke penyimpanan akhir. |
6 | selesai | Video sepenuhnya diproses dan siap untuk diputar. |
7 | gagal | Terjadi kesalahan selama pengolahan. |