Membangun aplikasi web di era modern memerlukan pondasi yang kokoh. Framework modern memberikan fleksibilitas luar biasa bagi developer untuk menghadirkan fitur kompleks secara cepat tanpa mengabaikan aspek keamanan dan keandalan sistem.
Tahapan Implementasi & Walkthrough Kode
Berikut adalah langkah demi langkah teknis yang dapat Anda ikuti langsung pada codebase Anda:
Tahap 1: Penulisan Kode & Konfigurasi
php artisan make:controller RajaOngkirController
Tahap 2: Penulisan Kode & Konfigurasi
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Http;
class RajaOngkirController extends Controller
{
/**
* API_KEY
*
* @var string
*/
protected $API_KEY = 'paste_disini_API_KEY_RajaOngkir';
/**
* getProvinces
*
* @return void
*/
public function getProvinces()
{
$response = Http::withHeaders([
'key' => $this->API_KEY
])->get('https://api.rajaongkir.com/starter/province');
$provinces = $response['rajaongkir']['results'];
return response()->json([
'success' => true,
'message' => 'Get All Provinces',
'data' => $provinces
]);
}
/**
* getCities
*
* @param mixed $id
* @return void
*/
public function getCities($id)
{
$response = Http::withHeaders([
'key' => $this->API_KEY
])->get('https://api.rajaongkir.com/starter/city?&province='.$id.'');
$cities = $response['rajaongkir']['results'];
return response()->json([
'success' => true,
'message' => 'Get City By ID Provinces : '.$id,
'data' => $cities
]);
}
/**
* checkOngkir
*
* @param mixed $request
* @return void
*/
public function checkOngkir(Request $request)
{
$response = Http::withHeaders([
'key' => $this->API_KEY
])->post('https://api.rajaongkir.com/starter/cost', [
'origin' => $request->origin,
'destination' => $request->destination,
'weight' => $request->weight,
'courier' => $request->courier
]);
$ongkir = $response['rajaongkir']['results'];
return response()->json([
'success' => true,
'message' => 'Result Cost Ongkir',
'data' => $ongkir
]);
}
}
Tahap 3: Penulisan Kode & Konfigurasi
use Illuminate\Support\Facades\Http;
Tahap 4: Penulisan Kode & Konfigurasi
/**
* API_KEY
*
* @var string
*/
protected $API_KEY = 'paste_disini_API_KEY_RajaOngkir';
Tahap 5: Penulisan Kode & Konfigurasi
$response = Http::withHeaders([
'key' => $this->API_KEY
])->get('https://api.rajaongkir.com/starter/province');
Tahap 6: Penulisan Kode & Konfigurasi
$provinces = $response['rajaongkir']['results'];
Tahap 7: Penulisan Kode & Konfigurasi
return response()->json([
'success' => true,
'message' => 'Get All Provinces',
'data' => $provinces // <-- data provinces
]);
Tahap 8: Penulisan Kode & Konfigurasi
$response = Http::withHeaders([
'key' => $this->API_KEY
])->get('https://api.rajaongkir.com/starter/city?&province='.$id.'');
Tahap 9: Penulisan Kode & Konfigurasi
$cities = $response['rajaongkir']['results'];
Tahap 10: Penulisan Kode & Konfigurasi
return response()->json([
'success' => true,
'message' => 'Get City By ID Provinces : '.$id,
'data' => $cities
]);
Tahap 11: Penulisan Kode & Konfigurasi
$response = Http::withHeaders([
'key' => $this->API_KEY
])->post('https://api.rajaongkir.com/starter/cost', [
'origin' => $request->origin,
'destination' => $request->destination,
'weight' => $request->weight,
'courier' => $request->courier
]);
Tahap 12: Penulisan Kode & Konfigurasi
$ongkir = $response['rajaongkir']['results'];
Tahap 13: Penulisan Kode & Konfigurasi
return response()->json([
'success' => true,
'message' => 'Result Cost Ongkir',
'data' => $ongkir
]);
Tahap 14: Penulisan Kode & Konfigurasi
Route::get('/provinces', [App\Http\Controllers\RajaOngkirController::class, 'getProvinces']);
Route::get('/cities/{id}', [App\Http\Controllers\RajaOngkirController::class, 'getCities']);
Route::post('/checkOngkir', [App\Http\Controllers\RajaOngkirController::class, 'checkOngkir']);
Selalu gunakan pendekatan deklaratif, validasi input seawal mungkin di boundary layer, dan lakukan logging terstruktur untuk memudahkan observability ketika sistem dijalankan di lingkungan cloud produksi.
Kesimpulan
Dengan mengikuti langkah-langkah terstruktur di atas, implementasi modul Anda akan jauh lebih rapi, aman dari bug umum, serta siap diskalakan ke lingkungan produksi.
Nantikan artikel tutorial praktis lainnya seputar fullstack development, microservices, dan otomasi AI di Blog Engineering SiHubung. Selamat mencoba!