：GenerateWebofficeToken

• Sebelum menggunakan API ini, pastikan Anda memahami sepenuhnya metode penagihan dan harga Intelligent Media Management (IMM).

• Kredensial akses berlaku selama 30 menit, sedangkan kredensial refresh berlaku selama 1 hari.

• Waktu kedaluwarsa yang dikembalikan dalam UTC, yaitu 8 jam di belakang UTC+8.

• Format file input yang didukung:

  • Dokumen pengolah kata (Word): doc, docx, txt, dot, wps, wpt, dotx, docm, dotm, dan rtf.

  • Dokumen presentasi (PPT): ppt, pptx, pptm, ppsx, ppsm, pps, potx, potm, dpt, dan dps.

  • Dokumen spreadsheet (Excel): et, xls, xlt, xlsx, xlsm, xltx, xltm, dan csv.

  • Dokumen PDF: pdf.

• Ukuran file maksimum adalah 200 MB.

• Jumlah halaman maksimum adalah 5.000.

• Untuk proyek yang dibuat sebelum 1 Desember 2023, penagihan didasarkan pada jumlah kali dokumen dibuka. Untuk proyek baru, penagihan didasarkan pada jumlah panggilan API. Untuk beralih ke model penagihan baru, Anda harus membuat proyek baru. Perhatikan bahwa satu panggilan API hanya dapat digunakan oleh satu pengguna. Jika panggilan API yang sama digunakan oleh beberapa pengguna, hanya pengguna terakhir yang dapat mengakses dokumen, dan izin akses pengguna lain akan dicabut.

• Aktifkan Message Service (MNS) di wilayah yang sama dengan IMM. Buat topik dan antrian, lalu konfigurasikan hubungan langganan. Anda kemudian dapat meneruskan nama topik MNS dalam parameter NotifyTopicName untuk menerima notifikasi ketika file disimpan. Untuk informasi lebih lanjut tentang kit pengembangan perangkat lunak (SDK) MNS, lihat Menerima dan menghapus pesan. Untuk contoh format JSON bidang Message dalam notifikasi penyimpanan file, lihat Format pesan notifikasi WebOffice.

Skenario umum

Contoh berikut menunjukkan struktur parameter untuk setiap skenario.

Pratinjau file dalam mode read-only (wajib untuk file PDF)

Untuk mempratinjau dokumen dalam mode read-only:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.pdf",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Pratinjau file dengan ekstensi nama file huruf kapital

Untuk mempratinjau file dengan ekstensi nama file huruf kapital, atur parameter Filename dengan ekstensi huruf kecil:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.DOCX",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Pratinjau hanya 5 halaman pertama dokumen

Untuk menampilkan hanya 5 halaman pertama dari dokumen 10 halaman:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Tambahkan kata sandi untuk pratinjau dokumen

Untuk mengatur kata sandi untuk pratinjau dokumen, atau membuka file sumber yang dilindungi kata sandi untuk pratinjau tanpa prompt kata sandi:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Password" : "123456",
    "Permission" : "{'Readonly':'true'}"
}

Tambahkan watermark ke pratinjau dokumen

Untuk menambahkan watermark selama pratinjau dokumen:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Watermark" : "{'Type':'1','Value':'watermark_value','Font':'bold 20px Serif'}",
    "Permission" : "{'Readonly':'true'}"
}

Sembunyikan bilah alat selama pratinjau dokumen

Untuk menyembunyikan bilah alat selama pratinjau dokumen:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Hidecmb" : "true",
    "Permission" : "{'Readonly':'true'}"
}

Berikan izin untuk mengedit online, melihat riwayat, menyalin, mencetak, dan mengekspor ke PDF

Untuk memberikan izin mengedit online, melihat riwayat, menyalin, mencetak, dan mengekspor ke PDF:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Permission" : "{'Readonly':'false','History':'true','Copy':'true','Print':'true','Export':'true'}"
}

Error umum

Proyek yang sesuai dengan `ProjectName` tidak ditemukan. Buka konsol IMM baru untuk memeriksa apakah proyek tersebut ada di wilayah yang ditentukan.

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource acs:imm::xxx:project/xxx is not found"
}

Parameter `User` wajib diisi. Periksa apakah parameter ini telah ditentukan.

{
    "Code": "InvalidArgument.User",
    "Message": "The parameter User is required but not provided"
}

Parameter `User` tidak valid. Periksa apakah nilai parameter dalam format JSON yang benar.

{
    "Code": "InvalidJSON parsing error, User",
    "Message": "Specified parameter JSON parsing error, User is not valid."
}

Parameter `Permission` tidak valid. Periksa apakah nilai parameter dalam format JSON yang benar.

{
    "Code": "InvalidJSON parsing error, Permission",
    "Message": "Specified parameter JSON parsing error, Permission is not valid."
}

Parameter `Watermark` tidak valid. Periksa apakah nilai parameter dalam format JSON yang benar.

{
    "Code": "InvalidJSON parsing error, Watermark",
    "Message": "Specified parameter JSON parsing error, Watermark is not valid."
}

Format parameter `PreviewPages` tidak valid. Periksa nilai parameter ini.

{
    "Code": "InvalidPreviewPages",
    "Message": "Specified parameter PreviewPages is not valid."
}

File OSS yang sesuai dengan `SourceURI` tidak ada. Periksa apakah file tersebut ada di bucket OSS.

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource oss://xx is not found"
}