Integrasikan PDS JavaScript SDK untuk manajemen file - Drive and Photo Service

aliyun-pds-js-sdk adalah SDK JavaScript yang disediakan oleh Drive and Photo Service (PDS). SDK ini memungkinkan Anda melakukan operasi dasar pada sumber daya PDS. Pengembang dapat menggunakannya untuk dengan mudah mengembangkan aplikasi PDS. Selain operasi file dasar seperti unggah, unduh, salin, pindah, dan hapus, SDK ini juga mendukung operasi pada sumber daya seperti drive, direktori dibagi, dan grup. SDK ini kompatibel dengan browser serta platform Node.js seperti Electron dan Node.

Repositori GitHub: https://github.com/aliyun/aliyun-pds-js-sdk.

Penting

Catatan: Drive and Photo Service SDK untuk JavaScript versi 1.0.0 ke atas tidak mendukung fitur dalam mode hosting.

Catatan

Versi dependensi Node.js harus 16.15.0 atau lebih baru.

Sumber daya Drive and Photo Service

Struktur berikut menunjukkan sumber daya dalam sebuah domain:

Domain/
  |-- Group                # Grup atau tim.
  |-- User                 # Pengguna.
  |-- Account              # Akun.
  |-- Drive                # Drive.
  |-- ShareLink            # Tautan berbagi.
  |-- File                 # Sumber daya terkait file, termasuk izin berbagi baru dan tempat sampah.

Seorang user dapat dikaitkan dengan beberapa accounts. Sebuah account digunakan oleh pengguna untuk masuk, seperti melalui DingTalk.
Sebuah group atau user dapat bersarang di dalam group lainnya. Pengguna dapat ditambahkan ke grup sebagai member.

Group/
  |-- Group
  |-- User

Pemilik dari sebuah drive dapat berupa grup atau pengguna.
Sebuah file harus dimiliki oleh sebuah drive.

Drive/          # Drive.
  |-- File

Instalasi

Jalankan perintah berikut untuk menginstal aliyun-pds-js-sdk:

npm i -S aliyun-pds-js-sdk

Catatan: Pastikan bahwa Node.js versi 16.15.0 atau lebih baru telah diinstal.

Impor

1. Gunakan SDK dalam proyek Vue atau React

import {PDSClient} from 'aliyun-pds-js-sdk/browser'

2. Gunakan SDK dalam lingkungan Node.js

const {PDSClient} = require('aliyun-pds-js-sdk')

3. Impor SDK dengan menggunakan tag script di browser

Setelah menginstal SDK menggunakan npm, Anda dapat menyalin file aliyun-pds-js-sdk.umd.cjs dari direktori node_modules/aliyun-pds-js-sdk/dist/browser/ ke server statis Anda atau layanan Alibaba Cloud CDN (CDN), lalu impor SDK menggunakan tag script.

<script src="/path/to/dist/browser/aliyun-pds-js-sdk.umd.cjs"></script>

const { PDSClient } = window.PDS_SDK

Kode contoh

Fitur API Drive and Photo Service diimplementasikan menggunakan metode dari kelas PDSClient. Untuk menggunakan fitur tersebut, buat instance PDSClient, lalu gunakan metode dari instance tersebut untuk memanggil operasi API Drive and Photo Service.

const domain_id = "ID dari domain" // Contoh: bj123.
const config = {
   token_info: {...},
   api_endpoint: `https://${domain_id}.api.aliyunpds.com`,
}

const pds = new PDSClient(config)

let { items=[], next_marker } = await pds.listDrives({ limit:10 })

Untuk informasi lebih lanjut tentang cara membangun parameter config, lihat PDSClient.