Membuat API dengan AI di WSO2 APIM

Dengan dirilisnya WSO2 API Manager versi 4.5.0, WSO2 membawa fitur baru, salah satunya adalah API Design Assistant!, meskipun masih dalam tahap eksperimen, kita bisa mencobannya, tanpa koding, kita tinggal perintahkan AI untuk membuat API yang sesuai dengan spsesifikasi yang kita tentukan dengan chatting dengan AI. Untuk tutorial kali ini kita akan mencoba langkah demi langkah bagaimana carannya membuat Rest API dengan AI di WSO API Manager. Berlangganan di AI Subscription Portal Pergi ke halaman Portal AI Subscription di : https://ai-subscriptions.wso2.com. Disini kita akan membuat token agar bisa menggunakan fitur API Design Assistant, untuk sekarang berlangganan di portal masih gratis hingga saat artikel ini dibuat. Buat akun baru dengan klik Register. Isi dengan email yang valid dan klik Register. Cek inbox, klik Complete Account Creation. Masukkan nama organisasi (nama organisasi bebas, ini diperlukan ketika login) dan password. Kembali ke halaman portal AI Subscription, klik Sign In dan masukkan organisasi yang sebelumnya diisi, masukkan username dan password, klik Sign In. Di halama utama, klik New Subscription. untuk contoh kali ini, isi Subscription Name dengan APIM-Dev, untuk description bersifat optional, pilih wso2am sebagai produknya, pilih Create. Kopi token hasil generate, pastikan token ini digunakan hanya untuk satu aplikasi, untuk aplikasi lainnya kita bisa buat lagi token selanjutnya. Konfigurasi WSO2 API Manager Buka file konfigurasi wso2 api manager di terminal dengan perintah: vim /repository/conf/deployment.toml Update pada bagian [apim.ai], tambahkan token yang didapat pada bagian sebelumnya, jangan lupa tambahkan endpoint seperti dibawah ini. [apim.ai] enable = true endpoint = "https://dev-tools.wso2.com/apim-ai-service/v2" key = "isi dengan token yang didapat" token_endpoint = "https://api.asgardeo.io/t/wso2devtools/oauth2/token" Restart api manager. Mencoba membuat API dengan AI Login ke halaman publisher. https://::9443/publisher Di Landing Page, klik tombol ‘Create API with AI’. Kita tinggal kirim perintahkan untuk membuat API sesuai keinginan. Dalam contoh ini kita akan membuat API tentang data pasien, gunakan perintah “create api for patient data”, untuk sementara AI masih menggunakan bahasa inggris untuk berinteraksi, sempat mencoba menggunakan bahasa indonesia, respon dari AI masih bahasa inggris, jadi amannya gunakan bahasa inggris untuk berinteraksi. Dari hasil yang ada AI akan membuat Standar CRUD untuk API, disini juga kita bisa menambahkan respon yang dibuat dengan extend / , pilih rest yang mau ditambahkan hasil dari returnnya, untuk contoh kali ini “also return when patient is registered” hasil dari respon ditambah value registered = true. Klik Create API, apabila sudah selesai membuat API, pilih Yes untuk melanjutkan, akan tampil wizard buat membuat API, isi sesuai dengan detail API yang dibuat. Detail API akan ditampilkan di halaman overview. Dengan adanya AI ini kita tinggal chating saja, sudah dibuat CRUDnya tanpa perlu kita belajar OPENAPI untuk membuatnya. Untuk sementara AI ini support REST, GraphQL dan Async (WebSub, WebSocket, SSE) API dan tidak support dengan AI API dan SOAP. Berhubung ini masih dalam tahap Experiment mungkin saja banyak terjadi perubahan setelah tutorial ini dibuat, silahkan komentar dibawah agar tutorial ini dapat diupdate ke versi yang terbaru, sampai jumpa lagi di artikel selanjutnya,

Apr 30, 2025 - 08:06

Dengan dirilisnya WSO2 API Manager versi 4.5.0, WSO2 membawa fitur baru, salah satunya adalah API Design Assistant!, meskipun masih dalam tahap eksperimen, kita bisa mencobannya, tanpa koding, kita tinggal perintahkan AI untuk membuat API yang sesuai dengan spsesifikasi yang kita tentukan dengan chatting dengan AI.

Untuk tutorial kali ini kita akan mencoba langkah demi langkah bagaimana carannya membuat Rest API dengan AI di WSO API Manager.

Berlangganan di AI Subscription Portal

Pergi ke halaman Portal AI Subscription di : https://ai-subscriptions.wso2.com. Disini kita akan membuat token agar bisa menggunakan fitur API Design Assistant, untuk sekarang berlangganan di portal masih gratis hingga saat artikel ini dibuat.
Buat akun baru dengan klik Register.

Isi dengan email yang valid dan klik Register.
Cek inbox, klik Complete Account Creation.
Masukkan nama organisasi (nama organisasi bebas, ini diperlukan ketika login) dan password.
Kembali ke halaman portal AI Subscription, klik Sign In dan masukkan organisasi yang sebelumnya diisi, masukkan username dan password, klik Sign In.
Di halama utama, klik New Subscription.

untuk contoh kali ini, isi Subscription Name dengan APIM-Dev, untuk description bersifat optional, pilih wso2am sebagai produknya, pilih Create.
Kopi token hasil generate, pastikan token ini digunakan hanya untuk satu aplikasi, untuk aplikasi lainnya kita bisa buat lagi token selanjutnya.

Konfigurasi WSO2 API Manager

Buka file konfigurasi wso2 api manager di terminal dengan perintah:

vim /repository/conf/deployment.toml

Update pada bagian [apim.ai], tambahkan token yang didapat pada bagian sebelumnya, jangan lupa tambahkan endpoint seperti dibawah ini.

[apim.ai]
enable = true
endpoint = "https://dev-tools.wso2.com/apim-ai-service/v2"
key = "isi dengan token yang didapat"
token_endpoint = "https://api.asgardeo.io/t/wso2devtools/oauth2/token"

Restart api manager.

Mencoba membuat API dengan AI

https://::9443/publisher

Di Landing Page, klik tombol ‘Create API with AI’.

Kita tinggal kirim perintahkan untuk membuat API sesuai keinginan. Dalam contoh ini kita akan membuat API tentang data pasien, gunakan perintah “create api for patient data”, untuk sementara AI masih menggunakan bahasa inggris untuk berinteraksi, sempat mencoba menggunakan bahasa indonesia, respon dari AI masih bahasa inggris, jadi amannya gunakan bahasa inggris untuk berinteraksi.

Dari hasil yang ada AI akan membuat Standar CRUD untuk API, disini juga kita bisa menambahkan respon yang dibuat dengan extend / , pilih rest yang mau ditambahkan hasil dari returnnya, untuk contoh kali ini “also return when patient is registered” hasil dari respon ditambah value registered = true.

Klik Create API, apabila sudah selesai membuat API, pilih Yes untuk melanjutkan, akan tampil wizard buat membuat API, isi sesuai dengan detail API yang dibuat.

Detail API akan ditampilkan di halaman overview.

Dengan adanya AI ini kita tinggal chating saja, sudah dibuat CRUDnya tanpa perlu kita belajar OPENAPI untuk membuatnya. Untuk sementara AI ini support REST, GraphQL dan Async (WebSub, WebSocket, SSE) API dan tidak support dengan AI API dan SOAP.

Berhubung ini masih dalam tahap Experiment mungkin saja banyak terjadi perubahan setelah tutorial ini dibuat, silahkan komentar dibawah agar tutorial ini dapat diupdate ke versi yang terbaru, sampai jumpa lagi di artikel selanjutnya,