author Ahmad Muhardian

Eksperimen dengan API Simsimi


Kali ini saya akan mengajak teman-teman bereksperimen dengan API Simsimi.

Apa itu Simsimi?

buat yang belum tau, silahkan instal saja aplikasi Simsimi di smarphone-nya.

Oke, mari kita mulai.

API Simsimi

API Simsimi konsepnya sangat sederhana. Kita hanya melakukan request dari URL dengan query string, lalu akan mendapatkan jawaban atau respon berdasarkan data yang dimiliki Simsimi. Respon tersebut, bisa kita olah untuk membuat Simsimi versi kita sendiri.

1. Mendapatkan Kunci API

Kunci API atau API Key, merupakan kunci yang digunakan untuk mengakses API Simsimi.

Ada dua jenis kunci API (API Key) yang disediakan oleh Simsimi:

  1. API Key percobaan (diberikan gratis selama 7 hari).
  2. API Key Berbayar. Untuk mendapatkan kunci API, silakan mendaftar di https://developer.simsimi.com/api. Isi data diri dan nama aplikasi yang akan dibuat. Setelah berhasil, nanti akan mendapatkan kunci API seperti ini.

Membuat API Key Simsimi

2. Membuat Request

Pembuatan Request dilakukan melalui URL dengan Query String. Kita disediakan dua jenis URL. Pertama, untuk yang menggunakan kunci API percobaan (gratis) dan untuk yang menggunakan kinci API berbayar.

  1. Kunci Percobaan: https://sandbox.api.simsimi.com/request.p
  2. Kunci Berbayar: https://api.simsimi.com/request.p

Berikut ini parameter untuk membuat request melalui URL di atas.

ParameterTipe DataWajibNilai DefaultKeterangan
keyStringYaKunci API
textStringYaQuery message
lcStringYaKode bahasa ( Cek di sini)
ftDouble(0.0 ~ 1.0)Tidak0.01.0 : ‘Bad Word Discriminator’

Nah, untuk membuat request-nya, silahkan susun URL-nya menjadi seperti ini:

https://sandbox.api.simsimi.com/request.p?key=KUNCI_API&lc=id&ft=1.0&text=tau petanikode?

Berikut ini contoh hasil requestnya melalui browser dengan query message “tau petanikode?”

Contoh Request dari Browser

Seperti yang kita dapatkan pada gambar di atas, responnya dalam bentuk JSON. Percobaan kedua saya lakukan dengan Postman.

Percobaan pengiriman request melalui postman

3. Membuat Aplikasi Chat

Oke, tiba saatnya di bagian yang paling menyenangkan. Jadi, setelah kita tahu respon dari API Simsimi berupa JSON. Kita tinggal melakukan penguraian (parsing) saja sehingga menjadi sebuah aplikasi.

Untuk melakukan ini, saya menggunakan bahasa pemrograman Python. Karena kodenya lebih sederhana dan singkat.

import urllib, json

print "Silahkan kirim pesan!"

while(True):
    pesan = raw_input("Anda: ")
    url = "https://sandbox.api.simsimi.com/request.p?key=KUNCI_API&lc=id&ft=1.0&text=%s" % pesan
    link_json = urllib.urlopen(url)
    data = json.loads(link_json.read())

    print "Petanikode-simi: %s" % data['response']

Baca juga:

Hasilnya, ketika dijalankan:

Aplikasi Chat Simsimi Berbasis CLI dengan Python

Referensi: https://developer.simsimi.com/api