Perubahan yang memutus kompatibilitas

Integrasi yang sudah berjalan wajib menyesuaikan nama parameter berikut sebelum memakai dokumen versi ini.

• Unggah Karya Digital Lainnya: parameter authors diganti menjadi author, dan bentuknya berubah dari satu string dipisah koma menjadi array author[role]=nama.
• Perbaikan Koleksi Bermasalah: parameter author[] diganti menjadi author dengan bentuk author[role]=nama.
• Perbaikan Koleksi Bermasalah: file_content diganti menjadi content, dan file_cover diganti menjadi cover.
• Perbaikan Koleksi Bermasalah: publish_time diganti menjadi tanggal_terbit, sekaligus formatnya dikunci menjadi dd-mm-yyyy. Sebelumnya menerima berbagai format tanggal.
• Perbaikan Koleksi Bermasalah: description diganti menjadi sinopsis, edition menjadi edisi, edition_date menjadi tanggal_edisi, dan binding menjadi jilid.
• Perbaikan Koleksi Bermasalah: price diganti menjadi harga, dan currency diganti menjadi mata_uang.
• Unggah Karya Digital Lainnya: response sukses mengembalikan AUTHOR berisi kontributor yang sudah terformat, menggantikan AUTHORS yang sebelumnya berisi kiriman mentah.

Parameter baru

• Unggah Buku ISBN: parameter harga wajib diisi, minimal 10000, hanya angka.
• Unggah Buku ISBN: parameter mata_uang wajib diisi, 3 karakter, misal IDR.
• Unggah Buku ISBN: parameter preview kini terdokumentasi. Wajib diisi jika access bernilai 2, 3, atau 4, dan boleh dikosongkan jika access bernilai 1.

Perubahan perilaku

• Unggah Buku ISBN: tanggal_terbit tidak lagi wajib dikirim jika ISBN tersebut sudah pernah memiliki tanggal konfirmasi terbit. Tanggal yang sudah tersimpan akan tetap dipakai dan tidak akan diperbarui, meskipun parameter ini dikirim dengan nilai berbeda.
• Unggah Buku ISBN: jika ISBN belum memiliki tanggal konfirmasi terbit, tanggal_terbit wajib dikirim dan akan disimpan sebagai tanggal terbit ISBN tersebut.
• Unggah Buku ISBN: harga dan mata uang kini ikut tersimpan pada data koleksi, baik saat unggah pertama kali maupun unggah ulang.
• Kontributor kini disimpan beserta rolenya dengan format "role, nama" yang dipisahkan tanda titik koma antar kontributor. Contoh: penulis, Audrey Mashita;penyunting, Sibami Babami.
• Satu role boleh diisi lebih dari satu orang dengan mengirim nilainya sebagai array, contoh author[penulis][]=Audrey Mashita dan author[penulis][]=Simarmata Dima.
• Perbaikan Koleksi Bermasalah: pembersihan angka pada harga disamakan dengan endpoint lain, sehingga spasi dan simbol mata uang ikut dibuang, tidak hanya titik dan koma.
• Perbaikan Koleksi Bermasalah: nilai mata_uang otomatis diubah menjadi huruf kapital.

Perbaikan dokumentasi

• Parameter access di seluruh endpoint kini menyertakan penjelasan lengkap keempat pilihan hak akses beserta konsekuensi pendayagunaannya.
• Unggah Buku ISBN: parameter isbn dan cover yang sebenarnya wajib namun belum tercantum, kini didokumentasikan.
• Unggah Buku ISBN: contoh cURL dilengkapi username, password, dan isbn yang sebelumnya tidak ikut tertulis.
• Unggah Buku ISBN: parameter name dihapus dari dokumentasi karena tidak pernah digunakan oleh endpoint tersebut.

Perubahan yang memutus kompatibilitas

Integrasi yang masih mengikuti versi 1.0 wajib mengubah cara pengiriman file sebelum memakai dokumen versi ini.

• Unggah file kini dikirim langsung sebagai parameter file melalui form-data, menggantikan cara lama yang mengirimkan tautan file.

Perubahan perilaku

• Proses unggah menjadi lebih cepat karena server tidak perlu lagi mengunduh file dari tautan yang dikirim penerbit.
• Keamanan meningkat karena file diterima langsung dari penerbit, sehingga server tidak lagi mengakses tautan eksternal dan isi file dapat diperiksa langsung saat diterima.