Raja Ongkir API Wrapper for Laravel
Mempermudah penggunaan API raja ongkir pada aplikasi berbasis laravel, (*1)
Dengan pacakage ini anda dapat menggunakan API Raja Ongkir dengan mudah karena sudah terintegrasi dengan facade laravel 5+., (*2)
, (*3)
Install Package Composer
-
Otomatis Menggunakan Composer:, (*4)
composer require agungjk/rajaongkir
-
Tambahkan Manual ke composer.json:, (*5)
{
"require": {
"agungjk/rajaongkir" : "dev-master"
}
}
Integrasi Ke Laravel
-
Tambahkan service provider ke config/app.php, (*6)
'providers' => [
....
Agungjk\Rajaongkir\RajaOngkirServiceProvider::class,
]
-
Tambahkan juga aliasnya ke config/app.php, (*7)
'aliases' => [
....
'RajaOngkir' => Agungjk\Rajaongkir\RajaOngkirFacade::class,
]
Publish Config Package Laravel
Jalankan command artisan berikut php artisan vendor:publish
untuk publish secara otomatis, atau menggunakan cara manual seperti berikut ini:, (*8)
- Buat file rajaongkir.php di folder /config secara manual
- Tambahkan Kodingan berikut ini:
php
<?php
return [
'end_point_api' => env('RAJAONGKIR_ENDPOINT', 'http://rajaongkir.com/api/starter'),
'api_key' => env('RAJAONGKIR_KEY', 'SomeRandomString'),
];
Setting Environment
Tambahkan kode berikut di file .env untuk konfigurasi API rajaongkir, (*9)
RAJAONGKIR_ENDPOINT=isi_base_url_api_akun_anda_disini
RAJAONGKIR_KEY=isi_api_key_anda_disini
atau anda juga dapat langsung melakukan konfigurasi di file rajaongkir.php di folder config seperti kode berikut., (*10)
'end_point_api' => 'isi_base_url_api_akun_anda_disini',
'api_key' => 'isi_api_key_anda_disini',
Contoh Penggunaan
Berikut adalah beberpa fungsi yang terdapat dalam package ini:
1. Mengambil Data Provinsi
a. Semua Data Provinsi
php
$list_provinsi = RajaOngkir::province();
b. Data Provinsi Berdasarkan ID
php
$provinsi_id = 1;
$data_provinsi = RajaOngkir::province($provinsi_id);
, (*11)
-
Mengambil Data Kota
a. Semua Data Kota, (*12)
$list_kota = RajaOngkir::city();
b. Data Kota Berdasarkan ID, (*13)
$kota_id = 1;
$data_kota = RajaOngkir::city($kota_id);
-
Mengkalkulasi Biaya, (*14)
$kota_asal_id = 501;
$kota_tujuan_id = 114;
$berat = 1700; // dalam gram
$kurir = "jne";
$list_biaya = RajaOngkir::cost($kota_asal_id, $kota_tujuan_id, $berat, $kurir);
Release History
- 0.2.0
- CHANGE: Rename function for more readable
- 0.1.0
Agung Jati Kusumo – @its_agungjk – agungjk.social@gmail.com, (*15)
Distributed under the MIT license. See LICENSE
for more information., (*16)
https://github.com/agungjk/rajaongkir, (*17)
Contributing
- Fork it (https://github.com/agungjk/rajaongkir/fork)
- Create your feature branch (
git checkout -b feature/fooBar
)
- Commit your changes (
git commit -am 'Add some fooBar'
)
- Push to the branch (
git push origin feature/fooBar
)
- Create a new Pull Request
Kunjungi rajaongkir, (*18)
Documentasi akun starter, (*19)