Skip to main content

Pendahuluan

Selamat datang di dokumentasi Nyandrive API.

Gambaran Umum​

Nyandrive API menyediakan serangkaian endpoint RESTful yang memungkinkan Anda untuk:

  • Melihat semua file
  • Melihat detail file berdasarkan ID
  • Mengunggah file
  • Mengubah nama file
  • Menghapus file ke dalam keranjang sampah
  • Menghapus file secara permanen

Autentikasi​

Semua permintaan API memerlukan autentikasi menggunakan token Bearer dalam header Authorization:

Authorization: Bearer YOUR_TOKEN

URL Dasar​

Semua permintaan API harus dilakukan ke:

https://drive.nyanhosting.id/api/v1

Persyaratan​

Untuk menggunakan Nyandrive API, Anda memerlukan:

  • Akun Nyandrive yang aktif
  • Token autentikasi API
  • Lingkungan pengembangan dengan salah satu dari:
    • PHP 7.4 atau lebih tinggi
    • Node.js 14.0 atau lebih tinggi
    • Alat apapun yang dapat membuat permintaan HTTP (cURL, Postman, dll.)

Format Respon​

Semua respon dikembalikan dalam format JSON. Respon sukses biasanya mengikuti struktur ini:

{
  "data": {
    // Data respon
  },
  "message": "Operasi berhasil",
  "status": 200
}

Penanganan Kesalahan​

Ketika terjadi kesalahan, API akan mengembalikan kode status HTTP yang sesuai dan pesan kesalahan:

{
  "error": {
    "message": "Deskripsi kesalahan",
    "code": "KODE_ERROR"
  },
  "status": 400
}

Batasan Rate​

API menerapkan pembatasan rate sebanyak 1000 permintaan per jam per token API. Informasi batas rate disertakan dalam header respon:

  • X-RateLimit-Limit: Jumlah permintaan yang diizinkan per jam
  • X-RateLimit-Remaining: Jumlah permintaan yang tersisa dalam jendela waktu saat ini