tutorial cara membuat web service.
Sebelum mulai memberikan paparan cara membuat web service, ada baiknya jelaskan dahulu tentang apa itu web service. Menurut Wikipedia, web service atau juga disebut Web API (Application Programming Interface) adalah layanan yang memungkinankan dua buah sistem atau lebih yang saling independen dapat saling berkomunikasi seperti halnya client server melalui protokol HTTP. Beberapa contoh implementasi web service adalah sistem login seperti yang ada di Kaskus, atau Detik.com.
Jika Anda mengunjungi Kaskus, maka Anda akan menjumpai sistem login yang dapat menggunakan akun Facebook, Yahoo maupun Twitter.
Dengan kata lain, Anda dapat bergabung dalam komunitas forum Kaskus atau istilah kerennya Kaskuser hanya dengan memiliki akun FB, Yahoo atau Twitter tanpa harus registrasi di dalam Kaskus nya sendiri.
Contoh lain implementasi web service adalah di bagian komentar Detik.com. Setiap kali kita akan mengisi komentar di Detik.com, kita bisa menggunakan akun FB kita.
Nah… yang menjadi pertanyaan adalah, kok bisa ya kita bisa masuk ke dalam sistem Kaskus maupun Detik.com menggunakan akun lain seperti FB, Yahoo maupun Twitter? Ya… ini karena FB, Yahoo dan Twitter menyediakan service yang memungkinkan sistem lain menggunakan akun mereka untuk login. Dan… kebetulan Kaskus dan Detik.com ini memanfaatkan service tersebut. Dalam kasus ini, FB, Yahoo, dan Twitter dikatakan bertindak sebagai server sedangkan Kaskus dan Detik.com bertindak sebagai client.
Nah… pada artikel ini, saya akan mencoba memaparkan cara membuat web service sederhana dengan studi kasus proses login menggunakan PHP dan MySQL.
Adapun skenario dari contoh kasus yang saya ambil di sini adalah andaikan terdapat dua buah sistem yang saling independen, katakanlah A dan B. Sistem A ini andaikan berada pada URL http://sistem-a. Di dalam sistem A ini, terdapat data user yang terdiri dari username dan password. Sedangkan di dalam sistem B yang berada pada URL http://sistem-b terdapat sistem login yang nantinya memanfaatkan user dan password yang ada di sistem A.
Ide untuk mengimplementasikan skenario di atas adalah: sebuah script harus diletakkan di dalam sistem B untuk memproses form login. Dalam proses login, script tersebut mengirim username dan password ke sistem A untuk dicek validitasnya melalui GET Request dengan parameter username dan password yang dibaca dari form login. Selanjutnya di dalam sistem A terdapat script untuk membaca username dan password yang berasal dari GET request dari sistem B untuk diproses validitasnya. Sebagai responnya, sistem A akan mengenerate sebuah dokumen XML yang di dalamnya terdapat sebuah data misalkan berbentuk TRUE atau FALSE. Bernilai TRUE jika username dan password tersebut valid, dan FALSE jika tidak valid. Selanjutnya di sistem B respon tersebut dibaca, jika data yang dibaca bernilai TRUE maka proses login berhasil dan jika FALSE maka login gagal.
Mungkin Anda bertanya, apakah response dari sistem yang bertindak sebagai server harus dalam bentuk XML? Jawabannya adalah tidak harus, selain bentuk XML kita juga bisa membuat respon dalam bentuk JSON karena dengan dokumen JSON struktur entitas data juga dapat dibaca dengan jelas seperti halnya XML.
OK sekarang saatnya tahap implementasi ide di atas ke dalam bentuk script PHP nya.
Pertama kita buat script untuk web service yang nantinya diletakkan di sistem A. Script ini nanti berfungsi untuk menangkap atau membaca GET request berupa data username dan password dari sistem lain, memproses validitasnya dan akhirnya mengenerate response dalam bentuk XML.
Sebelum kita buat scriptnya, kita ambil contoh struktur tabel username yang ada di sistem A adalah sbb:
dan berikut ini beberapa sampel datanya
Dalam sampel data username di atas, sengaja saya tidak enkrip
passwordnya supaya terlihat oleh Anda ketika uji coba proses loginnya.
Namun dalam implementasi yang sesungguhnya, sebaiknya dienkripsi ya…
Nah, kita bisa mulai membuat scriptnya sekarang.
service.php
Berikut ini adalah tampilan dokumen XML sebagai respon dari sistem A jika kita berikan GET request melalui URL
Sedangkan berikut ini tampilan jika diberikan GET request melalui URL
Nah… selanjutnya, kita buat script di sistem B untuk proses login termasuk form loginnya.
index.html
login.php
Keterangan:
Untuk membaca dan memparsing data XML yang diterima dari sistem A kita bisa menggunakan function
Wah.. lantas cara mencoba script di atas bagaimana ya? kan ada dua 2 sistem yang berbeda tuh? jangan khawatir, Anda dapat mencoba script di atas melalui localhost (PC lokal) dan hosting. Kita misalkan localhost adalah sistem B nya dan hostingnya adalah sistem A nya. Jadi, Anda buat database user dan script service.php nya di hosting, dan script form loginnya di localhost. Selanjutnya Anda tinggal mengubah URL web servicenya saja ke URL hosting Anda.
Nah… mudah bukan membuatnya??
Ups… tunggu dulu, sistem di atas sebenarnya sudah berjalan, namun.. apakah tidak rawan bila menggunakan GET request seperti di atas. Artinya bisa saja ada sistem lain katakanlah C yang sebenarnya tidak berhak mengakses web service ke sistem A yang menggunakan service tersebut untuk sistem loginnya. Nah.. dengan demikian kita perlu memproteksi GET request tersebut. Caranya bagaimana? ya… kita bisa gunakan kode API. Kode API ini diberikan oleh sistem A kepada sistem B atau sistem yang berhak mengakses web servicenya. Kode API berfungsi sebagai password dalam melakukan GET request. Jika kode API yang dikirim melalui GET request oleh suatu sistem tidak dikenal oleh sistem A berarti sistem tersebut tidak berhak mengakses web servicenya.
OK… untuk mengimplementasikan kode API sebagai pengaman GET request dalam web service, kita sedikit modifikasi script di atas, baik di script service.php (di sistem A) maupun di login.php nya (di sistem B). Dalam contoh ini, misalkan kode API yang diberikan kepada sistem B oleh sistem A ini berbentuk string ’1234′. Maka script service.php nya adalah
service.php
Selanjutnya di sistem B, script login.php nya perlu kita ubah parameter GET requestnya
login.php
OK, that’s it.. cara pengaplikasian kode API dalam web service. Nah…
silakan mengembangkan sendiri web service Anda. Penerapan web service
tidak selalu dalam sistem login seperti di atas, namun bisa juga untuk
keperluan lain, misalkan yang digunakan oleh Google Map
dimana kita bisa menyisipkan peta dari Google Map ke dalam situs atau
blog kita. Atau mungkin suatu saat PLN maupun PDAM atau korporasi lain
bisa membuat web service di sistem mereka, sehingga kita bisa dapat
dengan mudah mendevelop sendiri suatu sistem di web yang bisa
mengetahui besar tagihan. Semoga…
Sebelum mulai memberikan paparan cara membuat web service, ada baiknya jelaskan dahulu tentang apa itu web service. Menurut Wikipedia, web service atau juga disebut Web API (Application Programming Interface) adalah layanan yang memungkinankan dua buah sistem atau lebih yang saling independen dapat saling berkomunikasi seperti halnya client server melalui protokol HTTP. Beberapa contoh implementasi web service adalah sistem login seperti yang ada di Kaskus, atau Detik.com.
Jika Anda mengunjungi Kaskus, maka Anda akan menjumpai sistem login yang dapat menggunakan akun Facebook, Yahoo maupun Twitter.
Dengan kata lain, Anda dapat bergabung dalam komunitas forum Kaskus atau istilah kerennya Kaskuser hanya dengan memiliki akun FB, Yahoo atau Twitter tanpa harus registrasi di dalam Kaskus nya sendiri.
Contoh lain implementasi web service adalah di bagian komentar Detik.com. Setiap kali kita akan mengisi komentar di Detik.com, kita bisa menggunakan akun FB kita.
Nah… yang menjadi pertanyaan adalah, kok bisa ya kita bisa masuk ke dalam sistem Kaskus maupun Detik.com menggunakan akun lain seperti FB, Yahoo maupun Twitter? Ya… ini karena FB, Yahoo dan Twitter menyediakan service yang memungkinkan sistem lain menggunakan akun mereka untuk login. Dan… kebetulan Kaskus dan Detik.com ini memanfaatkan service tersebut. Dalam kasus ini, FB, Yahoo, dan Twitter dikatakan bertindak sebagai server sedangkan Kaskus dan Detik.com bertindak sebagai client.
Nah… pada artikel ini, saya akan mencoba memaparkan cara membuat web service sederhana dengan studi kasus proses login menggunakan PHP dan MySQL.
Adapun skenario dari contoh kasus yang saya ambil di sini adalah andaikan terdapat dua buah sistem yang saling independen, katakanlah A dan B. Sistem A ini andaikan berada pada URL http://sistem-a. Di dalam sistem A ini, terdapat data user yang terdiri dari username dan password. Sedangkan di dalam sistem B yang berada pada URL http://sistem-b terdapat sistem login yang nantinya memanfaatkan user dan password yang ada di sistem A.
Ide untuk mengimplementasikan skenario di atas adalah: sebuah script harus diletakkan di dalam sistem B untuk memproses form login. Dalam proses login, script tersebut mengirim username dan password ke sistem A untuk dicek validitasnya melalui GET Request dengan parameter username dan password yang dibaca dari form login. Selanjutnya di dalam sistem A terdapat script untuk membaca username dan password yang berasal dari GET request dari sistem B untuk diproses validitasnya. Sebagai responnya, sistem A akan mengenerate sebuah dokumen XML yang di dalamnya terdapat sebuah data misalkan berbentuk TRUE atau FALSE. Bernilai TRUE jika username dan password tersebut valid, dan FALSE jika tidak valid. Selanjutnya di sistem B respon tersebut dibaca, jika data yang dibaca bernilai TRUE maka proses login berhasil dan jika FALSE maka login gagal.
Mungkin Anda bertanya, apakah response dari sistem yang bertindak sebagai server harus dalam bentuk XML? Jawabannya adalah tidak harus, selain bentuk XML kita juga bisa membuat respon dalam bentuk JSON karena dengan dokumen JSON struktur entitas data juga dapat dibaca dengan jelas seperti halnya XML.
OK sekarang saatnya tahap implementasi ide di atas ke dalam bentuk script PHP nya.
Pertama kita buat script untuk web service yang nantinya diletakkan di sistem A. Script ini nanti berfungsi untuk menangkap atau membaca GET request berupa data username dan password dari sistem lain, memproses validitasnya dan akhirnya mengenerate response dalam bentuk XML.
Sebelum kita buat scriptnya, kita ambil contoh struktur tabel username yang ada di sistem A adalah sbb:
1.CREATE TABLE `user` (2.`username` varchar(20),3.`password` varchar(20),4.PRIMARY KEY (`username`)5.)1.INSERT INTO `user` VALUES ('user1', 'password1');2.INSERT INTO `user` VALUES ('user2', 'password2');Nah, kita bisa mulai membuat scriptnya sekarang.
service.php
01.<?php02. 03.// koneksi ke database di sistem A04.mysql_connect("dbhost", "dbuser", "dbpass");05.mysql_select_db("dbname");06. 07.// membaca username dari GET request08.$user = $_GET['username'];09.// membaca password dari GET request10.$pass = $_GET['password'];11. 12.// membaca data password user berdasar usernamenya13.$query = "SELECT * FROM user WHERE username = '$user'";14.$hasil = mysql_query($query);15.$data = mysql_fetch_array($hasil);16.$password = $data['password'];17. 18.// mencocokkan password user dari db dan dari GET request19.// jika cocok, maka responnya TRUE, jika tidak cocok responnya FALSE20.if ($pass == $password) $response = "TRUE";21.else $response = "FALSE";22. 23.// membuat header dokumen XML24.header('Content-Type: text/xml');25.echo "<?xml version='1.0'?>";26. 27.// membuat tag data respon pada dokumen XML28.echo "<data>";29.echo "<response>".$response."</response>";30.echo "</data>";31.?>1.http://sistem-a/service.php?username=user1&;password=xxxxxSedangkan berikut ini tampilan jika diberikan GET request melalui URL
1.http://sistem-a/service.php?username=user1&;password=password1Nah… selanjutnya, kita buat script di sistem B untuk proses login termasuk form loginnya.
index.html
1.<h1>Form Login</h1>2. 3.<form method="post" action="login.php">4.<table>5.<tr><td>Username</td><td><input type="text" name="username"></td></tr>6.<tr><td>Password</td><td><input type="password" name="password"></td></tr>7.<tr><td></td><td><input type="submit" name="submit" value="Submit"></td></tr>8.</form>01.<?php02. 03.// membaca username dari form login04.$username = $_POST['username'];05.// membaca password dari form login06.$password = $_POST['password'];07. 08.// membuat URL GET request ke sistem A09.$url = "http://sistem-a/service.php?username=".$username."&password=".$password; 10. 11.// mengirim GET request ke sistem A dan membaca respon XML dari sistem A12.$bacaxml = simplexml_load_file($url);13. 14.// membaca data XML hasil dari respon sistem A15.foreach($bacaxml->response as $respon)16.{17.// jika responnya TRUE maka login sukses18.// jika FALSE maka login gagal19.if ($respon == "TRUE") echo "Login Sukses";20.else if ($respon == "FALSE") echo "Login Gagal";21.} 22. 23.?>Untuk membaca dan memparsing data XML yang diterima dari sistem A kita bisa menggunakan function
simplexml_load_file().Wah.. lantas cara mencoba script di atas bagaimana ya? kan ada dua 2 sistem yang berbeda tuh? jangan khawatir, Anda dapat mencoba script di atas melalui localhost (PC lokal) dan hosting. Kita misalkan localhost adalah sistem B nya dan hostingnya adalah sistem A nya. Jadi, Anda buat database user dan script service.php nya di hosting, dan script form loginnya di localhost. Selanjutnya Anda tinggal mengubah URL web servicenya saja ke URL hosting Anda.
Nah… mudah bukan membuatnya??
Ups… tunggu dulu, sistem di atas sebenarnya sudah berjalan, namun.. apakah tidak rawan bila menggunakan GET request seperti di atas. Artinya bisa saja ada sistem lain katakanlah C yang sebenarnya tidak berhak mengakses web service ke sistem A yang menggunakan service tersebut untuk sistem loginnya. Nah.. dengan demikian kita perlu memproteksi GET request tersebut. Caranya bagaimana? ya… kita bisa gunakan kode API. Kode API ini diberikan oleh sistem A kepada sistem B atau sistem yang berhak mengakses web servicenya. Kode API berfungsi sebagai password dalam melakukan GET request. Jika kode API yang dikirim melalui GET request oleh suatu sistem tidak dikenal oleh sistem A berarti sistem tersebut tidak berhak mengakses web servicenya.
OK… untuk mengimplementasikan kode API sebagai pengaman GET request dalam web service, kita sedikit modifikasi script di atas, baik di script service.php (di sistem A) maupun di login.php nya (di sistem B). Dalam contoh ini, misalkan kode API yang diberikan kepada sistem B oleh sistem A ini berbentuk string ’1234′. Maka script service.php nya adalah
service.php
01.<?php02. 03.// koneksi ke database di sistem A04.mysql_connect("dbhost", "dbuser", "dbpass");05.mysql_select_db("dbname");06. 07.// membaca username dari GET request08.$user = $_GET['username'];09.// membaca password dari GET request10.$pass = $_GET['password'];11.// membaca kode API dari GET request12.$api = $_GET['api'];13. 14.// jika kode API nya '1234' maka lakukan proses validasi username dan password15.// jika kode API nya salah, maka proses validasi tidak dilakukan (diberikan respon "FALSE")16.if ($api == "1234")17.{18.// membaca data password user berdasar usernamenya19.$query = "SELECT * FROM user WHERE username = '$user'";20.$hasil = mysql_query($query);21.$data = mysql_fetch_array($hasil);22.$password = $data['password'];23. 24.// mencocokkan password user dari db dan dari GET request25.// jika cocok, maka responnya TRUE, jika tidak cocok responnya FALSE26.if ($pass == $password) $response = "TRUE";27.else $response = "FALSE";28.}29.else $response = "FALSE";30. 31.// membuat header dokumen XML32.header('Content-Type: text/xml');33.echo "<?xml version='1.0'?>";34. 35.// membuat tag data respon pada dokumen XML36.echo "<data>";37.echo "<response>".$response."</response>";38.echo "</data>";39.?>login.php
01.<?php02. 03.// membaca username dari form login04.$username = $_POST['username'];05.// membaca password dari form login06.$password = $_POST['password'];07. 08.// membuat URL GET request ke sistem A09.$url = "http://sistem-a/service.php?username=".$username."&password=".$password."&api=1234"; 10. 11.// mengirim GET request ke sistem A dan membaca respon XML dari sistem A12.$bacaxml = simplexml_load_file($url);13. 14.// membaca data XML hasil dari respon sistem A15.foreach($bacaxml->response as $respon)16.{17.// jika responnya TRUE maka login sukses18.// jika FALSE maka login gagal19.if ($respon == "TRUE") echo "Login Sukses";20.else if ($respon == "FALSE") echo "Login Gagal";21.} 22. 23.?>
