<h3>Pendahuluan</h3>
REST merupakan kependekan dari representational state transfer. Menurut REST Api Tutorial,REST adalah mekanisme alternatif yang lebih ringan dibandingkan RPC, SOAP, atau CORBA. REST sendiri memiliki implementasi yang berbeda - beda, jadi setiap orang dapat membuat versinya sendiri.

REST menggunakan HTTP Verb untuk melakukan proses operasi. Berikut adalah sejumlah HTTP Verb yang umum digunakan:
<ul>
	<li>GET, mendapatkan response berupa xml, json atau text</li>
	<li>HEAD, memberikan response berupa metadata</li>
	<li>POST, melakukan proses penciptaan data baru dengan mengirim request body berupa form-data, x-www-form-urlencoded, atau lainnya</li>
	<li>PUT, melakukan proses update terhadap suatu data dengan mengirim request body dan id dari suatu data</li>
	<li>DELETE, menghapus sebuah data berdasarkan id atau parameter tertentu</li>
</ul>
Sedangkan beberapa status code yang digunakan adalah sebagai berikut:
<ul>
	<li>200, resource yang diinginkan ada</li>
	<li>404, resource yang diinginkan tidak ada</li>
	<li>500, terjadi error saat meminta resource</li>
	<li>201, resource baru telah diciptakan</li>
	<li>dan lainnya.</li>
</ul>
Bila Taylor Otwell menciptakan Lumen dengan menggunakan komponen - komponen Laravel, maka SensioLabs mempunyai Silex. Silex sendiri merupakan sebuah micro web framework yang dikembangkan oleh SensioLabs dengan berbasiskan komponen - komponen Symfony. Ukuran file source code mentahnya pun terhitung ringan. Silex berukuran sebesar 1.6 MB sudah termasuk dependency library bawaan yang dikelola menggunakan Composer. Berbeda dengan beberapa micro web framework lain yang cukup besar ukurannya. Silex ini mendukung pembangunan web service salah satunya dengan konsep REST.
<h3>Persiapan alat</h3>
Anda pun dapat dengan mudah memilih jalan tanpa harus menggunakan Composer bila ingin menggunakan cara yang praktis. Untuk menggunakan Silex tidaklah ribet. Anda cukup mengunduh file .zip dari website resminya. Kemudian simpan di folder htdocs atau /var/www/html tempat Anda biasa mengembangkan aplikasi PHP.

Kita akan menggunakan MongoDB untuk menyimpan setiap data yang akan diterima oleh Silex. Anda dapat mengikuti tutorial <a href="https://www.codepolitan.com/tutorial/pdkt-dengan-mongodb/">pengenalan MongoDB di Codepolitan Tutorial</a> untuk memahami dan menguasai sedikit query dan konsep MongoDB.

perlengkapan yang akan kita butuhkan antara lain:
<ul>
	<li>XAMPP (bagi pengguna Windows atau Linux) atau Apache dan PHP5 bagi yang tidak ingin memasang Apache secara terpisah (bagi pengguna Linux atau BSD)</li>
	<li>MongoDB (Anda dapat mengunduhnya dari website resmi MongoDB)</li>
	<li>Code Editor, Anda dapat menggunakan code editor favorit Anda</li>
	<li>POSTMAN, sebuah aplikasi untuk mencoba aplikasi web yang melayani web service semisal REST. POSTMAN merupakan aplikasi chrome. Oleh karena itu Anda harus memasang chrome terlebih dahulu, kemudian memasang ekstensi POSTMAN di dalam chrome</li>
	<li>Silex, Anda dapat mengunduh Silex di website resminya kemudian pilih paket yang diinginkan</li>
	<li>Silex Official Documentation, tutorial ini hanya pengantar saja, untuk melihat cara dan teknik lengkapnya, Anda harus mengunduh official documentation Silex.</li>
</ul>
<h3>Membuat kode REST di file index.php</h3>
Agar fokus dengan implementasi REST, kita akan menggunakan database mytrip yang ada di artikel <a href="https://www.codepolitan.com/tutorial/pdkt-dengan-mongodb/">PDKT dengan MongoDB</a>. Kita akan menggunakan function bawaan PHP untuk MongoDB. Setelah kita unduh Silex, ekstrak bundelan tersebut kemudian beri nama dengan mytrip dan letakkan di dalam folder publik dari Apache (misal: htdocs atau /var/www/html):

Kemudian kita edit index.php dan kita akan melihat sebuah kode awal yang terdapat di Silex.
<pre><code>&lt;?php

require_once __DIR__.'/../vendor/autoload.php';
use Symfony\Component\HttpFoundation\Request;

$app = new Silex\Application();

$app-&gt;get('/hello', function () {
 return 'Hello!';
});
</code></pre>
Di dalam kode tersebut, terdapat pemanggilan library yang ada di dalam folder vendors dengan memanggil autoload.php. Kemudian kita menggunakan class Request untuk mengambil setiap nilai yang dikirimkan oleh client. Kemudian kita membuat sebuah objek Silex dengan menginstansiasi Silex melalui function Application(). Setelah itu kita definisikan URL /hello dengan method GET. Anda dapat mencoba memanggil URL /hello dengan POSTMAN. Hasilnya adalah Anda akan melihat POSTMAN menampilkan pesan berupa Hello !.

Sekarang kita akan mendefinisikan URL /trip dengan metode GET yang akan menampilkan semua trip yang terdapat di collection trip:
<pre><code>$app-&gt;get('/trip', function () use ($app) {
 $mongo_client = new MongoClient();
 $db = $mongo_client-&gt;mytrip;
 $trip = $db-&gt;trip;
 $cursor = $trip-&gt;find();
 $result = iterator_to_array($cursor);

 $temp_result = array();
 foreach ($result as $key =&gt; $val){
 $temp_result[] = $result[$key];
 }

 return $app-&gt;json( array ( 'msg' =&gt; 'daftar trip berhasil diambil', 'resp'=&gt;$temp_result) );
});
</code></pre>
Pada kode diatas, kita tidak memerlukan parameter tambahan oleh karena itu saat menulis closure yang dilewatkan ke dalam function get() tidak melewatkan parameter apapun. Kemudian kita lakukan koneksi ke MongoDB menggunakan MongoClient(). Kemudian memilih database mytrip lalu memanggil collection trip. Setelah itu kita gunakan method find() untuk mendapatkan semua document yang ada pada collection trip.

Hasil query tersebut kita konversi menjadi array karena hasil mentahnya tidak dapat kita tampilkan yang hanya akan membuat aplikasi menjadi error. Setelah menggunakank iterator_to_array(), kita lakukan konversi agar menjadi lebih sesuai dengan format yang akan ditampilkan di halaman client dengan looping foreach() { }. Dan terakhir kita tampilkan hasil query yang disimpan ke dalam sebuah array dengan key resp dan menyertakan juga sebuah pesan dengan key msg. Hasil query ditampilkan ke dalam response berupa JSON dengan method json() yang dimiliki objek Silex $app.

Mari kita lanjutkan dengan mendefinisikan URL /trip/{id} dengan metode GET yang akan menampilkan trip tertentu dengan menggunakan id dari suatu document:
<pre><code>$app-&gt;get('/trip/{id}', function ($id) use ($app){
 $mongo_client = new MongoClient();
 $db = $mongo_client-&gt;mytrip;
 $trip = $db-&gt;trip;
 $result = $trip-&gt;findOne( array("_id" =&gt; new MongoId($id)) );

 return $app-&gt;json( array ( 'msg' =&gt; 'trip berhasil diambil', 'resp'=&gt;$result) );
});
</code></pre>
Karena kita membutuhkan parameter, maka di closure kita lewatkan $id yang mereferensi kepada {id} sebaiknya namanya disamakan saja agar tidak membuat Anda pusing. Kemudian kita lakukan koneksi ke MongoClient(), mengambil database mytrip, dan memilih collection trip. Kemudian kita menggunakan method findOne() yang dimiliki objek collection.

Perhatikan pada pemanggilan findOne(), kita tidak dapat langsung menggunakan id document dalam bentuk string. Kita harus mengubahnya terlebih dahulu kedalam bentuk ObjectId yang dilakukan dengan menggunakan MongoId(). Setelah itu kita tampilkan hasil query tanpa melakukan konversi apapun.

Sekarang kita akan mendefinisikan URL /trip dengan metode POST yang akan melakukan proses pembuatan trip baru:
<pre><code>$app-&gt;post('/trip', function (Request $request) use ($app){
 $mongo_client = new MongoClient();
 $db = $mongo_client-&gt;mytrip;
 $trip = $db-&gt;trip;

 $new_trip = array(
 'name' =&gt; $request-&gt;request-&gt;get('name'),
 'category' =&gt; $request-&gt;request-&gt;get('category'),
 'city' =&gt; $request-&gt;request-&gt;get('city'),
 'description' =&gt; $request-&gt;request-&gt;get('description'),
 );

 $trip-&gt;insert($new_trip);

 return $app-&gt;json( array ( 'msg' =&gt; 'trip berhasil ditambah') );
});
</code></pre>
Pada kode diatas kita melewatkan parameter $request dengan tipe data berupa objek Request, karena kita akan mengakses data yang dikirimkan melalui metode POST. Seperti biasa kita melakukan koneksi ke MongoDB dan memilih collection trip. Kemudian kita mengakses data yang dikirimkan melalui metode POST dengan menggunakan $request-&gt;$request-&gt;get(). Kemudian kita bentuk ke dalam sebuah array, kemudian kita gunakan method insert() untuk membuat document baru.

Sekarang kita akan mendefinisikan URL /trip dengan metode PUT yang akan melakukan proses update terhadap sebuah trip:
<pre><code>$app-&gt;put('/trip/{id}', function (Request $request, $id) use ($app) {
 $mongo_client = new MongoClient();
 $db = $mongo_client-&gt;mytrip;
 $trip = $db-&gt;trip;

 $new_trip = array(
 'name' =&gt; $request-&gt;request-&gt;get('name'),
 'category' =&gt; $request-&gt;request-&gt;get('category'),
 'city' =&gt; $request-&gt;request-&gt;get('city'),
 'description' =&gt; $request-&gt;request-&gt;get('description'),
 );

 $trip-&gt;update(array( "_id" =&gt; new MongoId($id) ), array( '$set'=&gt;$new_trip ) );

 return $app-&gt;json( array ( 'msg' =&gt; 'trip berhasil diubah') );
});
</code></pre>
Tidak berbeda jauh saat kita membuat kode untuk metode POST. Perbedaan di metode PUT hanya terletak pada parameter id document yang dilewatkan pada proses update ini. Kemudian kita menggunakan method update() dengan melewatkan id document yang akan kita update, kemudian menggunakan operator $set untuk memodifikasi nilai setiap kolom dari document.

Sekarang kita akan mendefinisikan URL /trip/{id} dengan metode DELETE yang akan melakukan proses penghapusan terhadap sebuah trip:
<pre><code>$app-&gt;delete('/trip/{id}', function ($id) use ($app) {
 $mongo_client = new MongoClient();
 $db = $mongo_client-&gt;mytrip;
 $trip = $db-&gt;trip;
 $result = $trip-&gt;remove( array("_id" =&gt; new MongoId($id)) );

 return $app-&gt;json( array ( 'msg' =&gt; 'trip berhasil dihapus') );
});
</code></pre>
Hampir sama dengan metode GET, hanya saja kita menggunakan method remove() untuk menghapus suatu document. Terakhir kita panggil method run() yang akan menjalankan aplikasi Silex yang telah kita bangun:
<pre><code>$app-&gt;run();

</code></pre>
<h3>Menggunakan POSTMAN untuk Mencoba API</h3>
Untuk menggunakan POSTMAN, Anda hanya perlu menunjuk URL apa yang akan diproses, kemudian memilih metode yang akan digunakan (GET, POST, PUT, DELETE, atau lainnya). Kemudian ada beberapa pilihan seperti authorization, membuat custom header, dan membuat request body baik dalam bentuk form-data, x-www-form-urlencoded, raw, atau binary. Untuk metode PUT dan POST kita akan gunakan request body dalam bentuk x-www-form-urlencoded.

Berikut adalah contoh screenshot penggunaan POSTMAN untuk mencoba API yang telah kita bangun menggunakan Silex:

-- Postman saat mencoba URL /hello

<img class="alignnone size-large wp-image-7720" src="https://www.codepolitan.com/wp-content/uploads/2016/02/Selection_004-1-700x484.png" alt="Selection_004" width="700" height="484" />

-- Postman saat mencoba URL /trip dengan metode GET

<img class="alignnone size-large wp-image-7721" src="https://www.codepolitan.com/wp-content/uploads/2016/02/Selection_005-1-700x488.png" alt="Selection_005" width="700" height="488" />

-- Postman saat mencoba URL /trip/{id} dengan metode GET

<img class="alignnone size-large wp-image-7722" src="https://www.codepolitan.com/wp-content/uploads/2016/02/Selection_006-700x486.png" alt="Selection_006" width="700" height="486" />

-- Postman saat mencoba URL /trip dengan metode POST

<img class="alignnone size-large wp-image-7723" src="https://www.codepolitan.com/wp-content/uploads/2016/02/Selection_007-700x485.png" alt="Selection_007" width="700" height="485" />

-- Postman saat mencoba URL /trip/{id} dengan metode PUT

<img class="alignnone size-large wp-image-7724" src="https://www.codepolitan.com/wp-content/uploads/2016/02/Selection_008-700x482.png" alt="Selection_008" width="700" height="482" />

-- Postman saat mencoba URL /trip/{id} dengan metode DELETE

<img class="alignnone size-large wp-image-7725" src="https://www.codepolitan.com/wp-content/uploads/2016/02/Selection_009-700x476.png" alt="Selection_009" width="700" height="476" />
<h3>Penutup</h3>
Dengan mengikuti tutorial ini diharapkan bagi Anda yang belum mengenal REST dapat memulai mengembangkan API untuk aplikasi mobile atau web. Anda pun dapat mulai mempelajari tentang authentication untuk membendung sejumlah pengguna web service yang tidak diizinkan.

REST memang memiliki sejumlah standard. Salah satunya seperti yang terdapat pada REST versi <a href="https://www.nsa.gov/ia/_files/support/guidelines_implementation_rest.pdf">NSA (National Security Agency)</a> atau <a href="https://www.w3.org/2001/sw/wiki/REST">REST versi W3C</a>.Apakah kita akan mengimplementasikan standard tersebut atau tidak, hal itu dikembalikan kembali kepada kesepakatan tim pengembang yang memiliki kebijakan masing - masing. Bahkan di tutorial ini saja status code yang digunakan hanya 200 saja.

Mungkin di lapangan ada yang membuat web service dengan keharusan mengirimkan data berupa JSON, ada juga yang berupa data POST biasa, ada juga yang XML. Bahkan ada juga yang hanya mengimplementasikan metode GET dan POST saja. Hal yang paling penting adalah apakah menciptakan API yang mudah digunakan atau justru sulit digunakan bagi penggunanya.
<h3>Referensi</h3>
<ul>
	<li>The Silex Book</li>
	<li>Restful Service Best Practices - RestApiTutorial.Com</li>
	<li>MongoDB Official Documentation</li>
</ul>
(codepolitanteam)

Implementasi REST sederhana dengan MongoDB dan Silex

GenAI Video Fest adalah ajang kompetisi video kreatif yang diselenggarakan oleh CODEPOLITAN bekerjasama dengan Alibaba Cloud.

Kami menantang kreator, tech-enthusiast, dan siapa saja untuk mendobrak batas imajinasi menggunakan teknologi Generative AI terbaru. Di sini, kamu wajib menggunakan WAN Model Studio dari Alibaba Cloud sebagai tools utama untuk menghasilkan karya videomu (bisa dikombinasikan dengan tools editing lainnya).

Tunjukkan pada dunia bagaimana teknologi dan kreativitas bisa bersatu menciptakan karya visual yang berdampak!

Kategori Kompetisi
Pilih satu dari empat tema besar ini untuk karyamu:
* Humanity (Kemanusiaan): Cerita yang menyentuh hati, sosial, dan kepedulian antar sesama.
* Sports (Olahraga): Energi, semangat juang, dan dinamika dunia olahraga.
* Entertainment (Hiburan): Komedi, musik, video klip, atau parodi yang menghibur.
* Science (Sains): Visualisasi masa depan, teknologi, alam semesta, atau penemuan ilmiah.

Total Prize Pool senilai Rp 250.000.000 menunggu para pemenang!
* Top Winners Rewards: Uang Tunai, Alibaba Cloud Credits (hingga $500), Merchandise Eksklusif, dan SWAG CODEPOLITAN.
* Lucky Draw Event: Kesempatan menang hadiah tambahan bagi peserta yang beruntung.
* Massive Exposure: Karya terbaik akan di-highlight di media sosial CODEPOLITAN, Alibaba Cloud, dan channel industri kreatif lainnya.
* Special Access (Khusus Alumni RuangAI): Dapatkan 2 Token untuk klaim Kelas Spesialisasi di RuangAI secara gratis.

Jangan sampai ketinggalan tanggal penting ini:
* Pendaftaran & Submission: 23 Desember 2024 - 23 Januari 2025
* Penjurian (Judging Phase): 24 - 26 Januari 2025
* Pengumuman Pemenang: 27 Januari 2025

Cara Ikutan:
1. Daftar: Klik tombol "Daftar Sekarang" dan pastikan kamu punya akun RuangAI.
2. Join Discord: Masuk ke server Discord komunitas untuk info teknis dan diskusi.
3. Create: Buat video kreatifmu menggunakan WAN Model Studio (Alibaba Cloud) sesuai kategori pilihan.
4. Upload & Submit: Unggah videomu ke media sosial (IG/TikTok/YouTube) dan submit link karyamu di halaman submission RuangAI.

Ikuti kompetisi video Generative AI terbesar dari CODEPOLITAN dan Alibaba Cloud! Gunakan teknologi WAN Model Studio untuk menyulap ide liarmu menjadi visual memukau. Rebut total hadiah senilai Rp 250.000.000!

GenAI Video Fest

Program Beasiswa Belajar Generative AI Chapter 4 hadir sebagai kelanjutan dari komitmen jangka panjang kolaborasi antara CODEPOLITAN dengan mitra global: Google.org, AVPN, dan Asian Development Bank (ADB). Program ini tetap dijalankan secara terpusat melalui ekosistem RuangAI.

Pada Chapter 4 ini, kami membawa semangat kolaborasi ke tingkat yang lebih tinggi. Selain tetap menyediakan kurikulum fundamental Generative AI berstandar Google untuk empat kategori utama peserta (Mahasiswa, Pencari Kerja, Siswa Vokasi, dan UMKM), RuangAI kini melakukan ekspansi strategis dengan menggandeng berbagai komunitas di seluruh Indonesia.

Program beasiswa fundamental Generative AI berstandar Google untuk Mahasiswa, Pencari Kerja, Siswa Vokasi, dan UMKM yang siap naik level di era AI.

Implementasi REST sederhana dengan MongoDB dan Silex

Learning

KelasFullstack

RuangAI

JagoanSiber

Baca Artikel Lainnya

PDKT dengan MongoDB

Implementasi REST sederhana dengan MongoDB dan Silex

Membangun Aplikasi Web Sederhana dengan Angular.js dan REST (Bagian 1)

Membangun Aplikasi Web Sederhana dengan Angular.js dan REST (Bagian 2)

Membangun Aplikasi Web Sederhana dengan Angular.js dan REST (Bagian 3 - END)

Memulai Pembuatan Aplikasi Web dengan Yii2 (1): Instalasi