Buat sebuah share.
Deskripsi operasi
Share, juga dikenal sebagai file sharing, adalah wadah tampilan file yang mengekspos satu atau beberapa file dari user space kepada pengguna anonim. Pengguna anonim dapat mengakses file-file tersebut sesuai dengan izin yang ditetapkan pada share tersebut.
Coba sekarang
Test
RAM authorization
Sintaks permintaan
POST /v2/share_link/create HTTP/1.1Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
Parameter permintaan. |
|
| drive_id |
string |
Yes |
ID drive. |
1 |
| share_all_files |
boolean |
No |
Menentukan apakah akan membagikan semua file dalam drive. |
true |
| file_id_list |
array |
No |
ID file yang akan dibagikan di path induk. Jumlah file dalam path induk berkisar antara 1 hingga 100. Jika share_all_files diatur ke true, parameter ini tidak berlaku. Jika tidak, Anda harus menentukan parameter ini. |
["520b217f13adf4fc24f2191991b1664ce045b393"] |
|
string |
No |
ID file yang akan dibagikan di path induk. |
9520943DC264 |
|
| user_id |
string |
No |
ID pengguna. |
u123 |
| share_pwd |
string |
No |
Kode akses. Kode akses harus memiliki panjang 0 hingga 64 byte. Jika Anda tidak menentukan parameter ini atau membiarkannya kosong, file dapat diakses tanpa kode akses. Dalam kasus ini, Anda tidak perlu menentukan parameter share_pwd saat memanggil operasi untuk mengkueri URL share. Kode akses hanya boleh berisi karakter ASCII yang terlihat. |
abcF123x |
| expiration |
string |
No |
Waktu kedaluwarsa URL share. Nilai parameter ini mengikuti standar RFC 3339. Contoh: "2020-06-28T11:33:00.000+08:00". Jika expiration diatur ke "", URL share tidak pernah kedaluwarsa. |
2020-06-28T11:33:00.000+08:00 |
| description |
string |
No |
Deskripsi share. Deskripsi harus memiliki panjang 0 hingga 1.024 karakter. |
百家讲坛合集 |
| share_name |
string |
No |
Nama share. Jika Anda membiarkan parameter ini kosong, nama file yang sesuai dengan ID pertama dalam daftar ID file akan digunakan. Nama harus memiliki panjang 0 hingga 128 karakter. |
百家讲坛-1.MP4 |
| disable_preview |
boolean |
No |
Menentukan apakah akan menonaktifkan fitur pratinjau. |
false |
| disable_save |
boolean |
No |
Menentukan apakah akan menonaktifkan fitur dump. |
false |
| disable_download |
boolean |
No |
Menentukan apakah akan menonaktifkan fitur unduh. |
false |
| preview_limit |
integer |
No |
Batas jumlah kali file yang dibagikan dapat dipratinjau. Nilai parameter ini harus lebih besar dari atau sama dengan 0. Nilai 0 menunjukkan tidak ada batas. |
100 |
| save_limit |
integer |
No |
Batas jumlah kali file yang dibagikan dapat didump. Nilai parameter ini harus lebih besar dari atau sama dengan 0. Nilai 0 menunjukkan tidak ada batas. |
100 |
| download_limit |
integer |
No |
Batas jumlah kali file yang dibagikan dapat diunduh. Nilai parameter ini harus lebih besar dari atau sama dengan 0. Nilai 0 menunjukkan tidak ada batas. |
100 |
| require_login |
boolean |
No |
Memerlukan login sebelum mengizinkan akses ke share |
true |
| office_editable |
boolean |
No |
Mengizinkan Pengeditan daring dokumen yang dibagikan |
true |
| creatable |
boolean |
No |
Mengizinkan pembuatan file dalam folder dalam share. Saat creatable bernilai true, parameter creatable_file_id_list juga harus disediakan. |
true |
| creatable_file_id_list |
array |
No |
Daftar ID file folder tempat unggahan diizinkan |
|
|
string |
No |
ID file folder |
9520943DC264 |
Elemen respons
|
Element |
Type |
Description |
Example |
| ShareLink |
Data yang dikembalikan. |
Contoh
Respons sukses
JSONformat
{
"share_id": "7JQX1FswpQ8",
"share_pwd": "abcF123x",
"drive_id": "1",
"file_id_list": [
"[\"xx\"]"
],
"expiration": "2020-06-28T11:33:00.000+08:00",
"expired": false,
"created_at": "2019-08-20T06:51:27.292Z",
"updated_at": "2019-08-20T06:51:27.292Z",
"description": "videos",
"share_name": "video-1.MP4",
"creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
"status": "enabled",
"preview_count": 10,
"save_count": 2,
"download_count": 5,
"report_count": 0,
"video_preview_count": 1,
"access_count": 4,
"disable_preview": false,
"disable_save": false,
"disable_download": false,
"preview_limit": 100,
"save_limit": 100,
"download_limit": 100,
"require_login": false,
"share_all_files": true,
"share_msg": "pwd: 123",
"save_download_limit": 100,
"office_editable": true
}Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.