Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Pada hari Selasa, 2 Juni 2015, kami merilis versi cloud baru dari Portal Layanan Developer Apigee.
Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.
Untuk mengetahui daftar semua catatan rilis Apigee Edge, lihat Catatan Rilis Apigee.
Fitur baru
Ketersediaan umum SmartDocs
SmartDocs dirilis dari versi beta ke ketersediaan umum. Update dan fitur baru meliputi:
- Dukungan untuk Swagger 2.0, termasuk impor menurut file atau URL, termasuk dukungan untuk objek keamanan bernama khusus.
- Peningkatan desain visual dalam template yang membuat SmartDocs.
- Peningkatan kegunaan dan alur kerja di Portal Developer, tersedia melalui menu Content > SmartDocs di Drupal.
- Apa yang sebelumnya dikenal sebagai autentikasi "Token Kustom" kini disebut "Kunci API".
- Objek "keamanan" autentikasi yang ditentukan di tingkat revisi.
- Konfigurasi autentikasi klien di level template. Revisi baru tidak lagi mereset kredensial klien SmartDocs yang telah dikonfigurasi sebelumnya.
Untuk deskripsi fitur lainnya, lihat postingan blog ini.
Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
Proses upgrade SmartDocs
Jika Anda telah menggunakan SmartDocs selama periode beta, fitur dan kemampuan baru dalam versi ketersediaan umum mengharuskan Anda mengupgrade SmartDocs dalam portal developer.
Setiap halaman SmartDocs yang telah dipublikasikan di portal developer Anda akan tetap berfungsi, tetapi Anda harus mengikuti proses pembaruan sebelum mengedit atau memublikasikan perubahan apa pun ke halaman yang sudah ada atau baru.
Perlu diingat bahwa meskipun Anda dapat merender dan memublikasikan SmartDocs di dalam portal developer, SmartDocs dibuat dari model API yang berada dalam Layanan Pengelolaan Edge API Apigee. Perubahan apa pun yang Anda buat pada model API di Edge akan sama di semua lingkungan Pantheon (serupa dengan cara developer berada di seluruh lingkungan Pantheon).
Untuk mengupgrade dari SmartDocs beta ke ketersediaan umum
- Update dan uji rilis 15.05.27 di lingkungan dev atau test di Pantheon.
- Buat model baru untuk menggantikan model API yang ada yang telah Anda gunakan.
- Jika Anda telah mengimpor dokumen Swagger atau WADL, impor lagi ke revisi baru.
- Jika Anda telah mempertahankan model API melalui modul SmartDocs, ekspor sebagai JSON SmartDocs dan impor ke model baru menggunakan lampiran file.
- Tetapkan properti keamanan revisi model Anda. Di halaman Konten >
SmartDocs > model, pilih Setelan Keamanan.
- Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Content > SmartDocs) dengan mengklik Settings di kolom Operations.
- Update template kustom apa pun agar menggunakan aset CSS dan JS v6, lalu buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk mengetahui informasi tentang cara mengupdate template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
- Render ulang dan publikasikan revisi model Anda.
- Setelah memvalidasi dokumentasi baru, update portal production Anda ke rilis 15.05.27.
Jika Anda adalah pelanggan Edge Enterprise dan memiliki pertanyaan atau masalah tentang proses upgrade, kirim email ke marsh@apigee.com dan cnovak@apigee.com. Atau, gunakan Komunitas Apigee untuk mendapatkan respons terbaik.
Bug telah diperbaiki
Bug berikut telah diperbaiki dalam rilis ini.
ID Masalah | Deskripsi |
---|---|
DEVSOL-487 | Format hari dalam Monetisasi harus dapat dikonfigurasi oleh admin Format tanggal kini dapat dikonfigurasi di Monetisasi di bagian setelan monetisasi untuk format tanggal Eropa dan Amerika Serikat. |
DEVSOL-603 | Halaman Rencana Konflik tidak diformat dengan baik Saat membeli paket yang tumpang-tindih dengan paket yang ada, halaman yang ditampilkan sekarang diformat dengan baik untuk pengguna. |
DEVSOL-642 | Memindahkan konfigurasi tingkat klien dari setelan keamanan ke setelan template |
DEVSOL-709 | SmartDocs: Parameter template URL tidak dapat diedit setelah mengirim permintaan dengan nilai
kosong Memperbaiki masalah yang membuat parameter template tidak dapat diedit setelah mengirim permintaan dari SmartDocs setelah menghapus parameter template dalam dokumentasi metode. |
DEVSOL-1013 | Membuat alamat email pengguna Portal Dev dapat diedit Kolom alamat email di halaman edit profil tidak akan dinonaktifkan lagi dan developer dapat mengubah alamat email mereka. |
DEVSOL-1273 | "DevConnect Mint" muncul dua kali dalam daftar Module Di bagian Modules, "Dev Connect Mint" ditampilkan dua kali. Hal ini sekarang telah diperbaiki. |
DEVSOL-1313 | Mendukung Impor File JSON/YAML atau URL untuk Swagger dan WADL File WADL sekarang dapat diimpor melalui URL dan file Swagger dapat diupload. |
DEVSOL-1339 | Mengubah lokasi menu Admin SmartDocs SmartDocs kini berada di menu konten, dan setelan smartdocs berada di menu admin setelan. |
DEVSOL-1340 | Hapus Beta saat masuk ke GA SmartDocs kini berada di menu konten, dan setelan smartdocs berada di menu admin setelan. |
DEVSOL-1390 | Library PHP SDK Edge telah diupdate untuk memperbaiki masalah pemanggilan
__toString() Library PHP SDK Edge telah diupdate untuk memperbaiki masalah pemanggilan baris __toString() pada objek DeveloperRatePlan yang menghasilkan error ini: {tanda kutip} Error fatal: Panggil ke anggota fungsi format() pada non-objek di metode /Applications/MAMP/htdocs/ordnance/docelibraries() |
DEVSOL-1398 | SmartDocs Petstore Model yang diimpor saat penginstalan tanpa permintaan pengguna SmartDocs kini mengimpor contoh swagger petstore selama penginstalan di situs (http://petstore.swagger.io/v2/swagger.json), bukan model cuaca, untuk memiliki contoh penggunaan SmartDocs yang lebih lengkap. |
DEVSOL-1407 | Cron gagal saat ada banyak developer Saat menjalankan cron Drupal, sejumlah besar developer menyebabkan masalah waktu tunggu habis. Jika sebuah organisasi memiliki lebih dari 200 pengguna, kini proses batch digunakan. |
DEVSOL-1470 | Buat link Menu "API" dan tampilan yang sesuai SmartDocs Portal Dev kini hadir secara default dengan link ke dokumentasi yang dirender SmartDocs di menu utama bernama "API", yang menautkan ke model apa pun dengan metode yang dipublikasikan. |
Masalah Umum
Rilis ini berisi masalah umum berikut:
ID Masalah | Deskripsi |
---|---|
DEVSOL-1558 |
Halaman metode SmartDocs Contoh Petstore tidak dirender dengan benar pada penginstalan baru
Contoh halaman metode Petstore di SmartDocs tidak dirender dengan benar saat penginstalan baru. Untuk menyelesaikan masalah ini:
Node seharusnya dirender dengan benar sekarang. |