README

此包使用 RuangAPI.com 服务

安装

使用 composer 下载包

composer require daengwebid/laravelongkoskirim

或

{
	"require": {
		"daengwebid/laravelongkoskirim" : "dev-master"
	}
}

自 Laravel 5.5 及以上版本，已包含包发现功能，因此无需注册包。

可选

对于 Laravel 5.4 及以下版本的用户，请将服务提供者添加到 config/app.php

'providers' => [
	....
	
	Daengweb\OngkosKirim\OngkirServiceProvider::class,
]

同时也在 config/app.php 中添加别名

'aliases' => [
	....
	
	'RuangApi' => Daengweb\OngkosKirim\RuangApiFacade::class,
]

结束可选

请手动在 config 文件夹中创建 ruangapi.php 文件并添加以下代码

<?php

return [
	/*
    | Dokumentasi : https://ruangapi.com/dokumentasi/ongkos-kirim
    */

	'ruangapi_shipping' => env('RUANGAPI_SHIPPING', 'https://ruangapi.com/api/v1/shipping'),
	'ruangapi_province' => env('RUANGAPI_SHIPPING', 'https://ruangapi.com/api/v1/provinces'),
	'ruangapi_city' => env('RUANGAPI_SHIPPING', 'https://ruangapi.com/api/v1/cities'),
	'ruangapi_district' => env('RUANGAPI_SHIPPING', 'https://ruangapi.com/api/v1/districts'),

	/*
    | Isi dengan APIKey yang didapatkan dari RuangAPI
    |
    */

	'api_key' => env('RUANGAPI_KEY', ''),
];

或运行 artisan 命令以自动发布配置

php artisan vendor:publish

如果使用上述 artisan 命令，将在 config 文件夹中创建 ruangapi.php 文件

在 .env 文件中添加以下代码以配置 ruangapi API

'RUANGAPI_KEY' => 'isi_api_key_anda'

或您也可以直接在 config 文件夹中的 ruangapi.php 文件中按照以下代码进行配置。

'api_key' => env('RUANGAPI_KEY', 'isi_key_anda_disini'),

使用方法

获取省份数据

$data = RuangApi::getProvinces();

//PASSING SECARA SPESIFIK BERDASARKAN ID PROPINSI
$data = RuangApi::getProvinces(1);

获取城市/县数据

$data = RuangApi::getCities(3, null, null);

//PARAMETER PERTAMA = ID PROPINSI
//PARAMETER KEDUA = ID KOTA (OPSIONAL)
//PARAMETER KETIGA = STRING NAMA KOTA (OPSIONAL)

获取区/镇数据

$data = RuangApi::getDistricts(157, null, 'airu');

//PARAMETER PERTAMA = ID KOTA
//PARAMETER KEDUA = ID KECAMATAN (OPSIONAL)
//PARAMETER KETIGA = STRING NAMA KECAMATAN (OPSIONAL)

获取运输费用

$data = RuangApi::getCost([
        'origin' => 22, //ID KOTA PENGIRIMAN
        'destination' => 2137, //ID KECAMATAN TUJUAN PENGIRIMAN
        'weight' => 600, //BERAT DALAM SATUAN GRAM
        'courier' => 'jne,jnt' //KODE KURIR, PISAHKAN DENGAN KOMA
    ]);

访问 daengweb

RuangAPI 文档