README

RajaOngkir 的 PHP 客户端 API

PHP 包，用于轻松访问 RajaOngkir API。

特性

• 列出所有省份。
• 根据ID获取省份。
• 根据名称搜索省份。
• 列出所有城市/县。
• 根据省份ID列出城市/县。
• 根据ID获取城市/县。
• 根据名称搜索城市/县。
• 获取运费（运费/运费）。

待办事项

• 基本和Pro账户类型的特性。
• 使用 Fuse 进行模糊搜索。

系统要求

• PHP 7.0（建议使用 PHP 7.1 或更高版本）。

安装

使用 Composer 安装此库。

$ composer require kavist/rajaongkir:^1.1

您也可以在 composer.json 中添加依赖。

{
    "require": {
        "kavist/rajaongkir": "^1.1"
    }
}

与 Laravel 集成

对于 Laravel 5.5 或更高版本的用户，此包将自动通过 auto-discovery 功能可用。您可以直接跳转到下面的 Laravel 配置 部分。

对于 Laravel 5.5 以下版本的用户，本项目中代码未经 Laravel 5.5 以下版本测试。 因此，如果此库无法正常运行，请谅解。

配置

对于 PHP native 用户，在实例化 class Kavist\RajaOngkir\RajaOngkir 时将 API 密钥作为参数声明。

$rajaOngkir = new RajaOngkir('isi_API_key_Anda_disini');

Laravel 配置

您只需将包含 API 密钥的 RAJAONGKIR_API_KEY 值设置为 环境变量。

RAJAONGKIR_API_KEY=isi_API_key_Anda_disini

您还可以发布此包的配置文件以进行更详细的配置。

$ php artisan vendor:publish --provider="Kavist\RajaOngkir\Providers\LaravelServiceProvider"

使用方法

省份

列出省份

要获取省份列表，请使用方法 provinsi()->all()。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->provinsi()->all();

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::provinsi()->all();

根据ID获取省份

要根据ID获取省份，请使用方法 provinsi()->find(int|string $id)。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->provinsi()->find(11);

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::provinsi()->find(11);

根据名称搜索省份

要根据名称搜索省份，请使用方法 provinsi()->search(string $searchTerm)->get()。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->provinsi()->search('ja')->get();

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::provinsi()->search('ja')->get();

城市/县

列出城市/县

要获取城市/县列表，请使用方法 kota()->all()。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->all();

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->all();

根据ID获取城市/县

要根据ID获取城市/县，请使用方法 kota()->find(int|string $id)。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->find(80);

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->find(80);

根据省份ID列出城市/县

要根据省份ID获取城市/县，请使用方法 kota()->dariProvinsi(int|string $provinceId)->get()。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->dariProvinsi(11)->find(80);

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->dariProvinsi(11)->find(80);

根据名称搜索城市/县

要根据名称搜索城市/县，请使用方法 kota()->search(string $searchTerm)->get()。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->search('su')->get();

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->search('su')->get();

您也可以在调用 search() 方法之前调用 dariProvinsi() 方法来从特定省份搜索城市/县。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->dariProvinsi(11)->search('su')->get();

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->dariProvinsi(11)->search('su')->get();

搜索运费

要获取运费，请使用方法 ongkosKirim(array $payload)。

// Native PHP
use Kavist\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->ongkosKirim([
    'origin'        => 155,     // ID kota/kabupaten asal
    'destination'   => 80,      // ID kota/kabupaten tujuan
    'weight'        => 1300,    // berat barang dalam gram
    'courier'       => 'jne'    // kode kurir pengiriman: ['jne', 'tiki', 'pos'] untuk starter
]);

// Laravel
use Kavist\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::ongkosKirim([
    'origin'        => 155,     // ID kota/kabupaten asal
    'destination'   => 80,      // ID kota/kabupaten tujuan
    'weight'        => 1300,    // berat barang dalam gram
    'courier'       => 'jne'    // kode kurir pengiriman: ['jne', 'tiki', 'pos'] untuk starter
]);

除了 ongkosKirim() 方法外，还有 ongkir() 和 biaya() 方法作为 ongkosKirim() 方法的别名。

测试

使用以下命令运行测试。

$ vendor/bin/phpunit

变更日志

请阅读 变更日志 以获取完整信息。

想要贡献？

请阅读 贡献指南 以获取完整信息。

贡献者

• Ian Mustafa
• 所有贡献者

许可证

麻省理工学院许可证（MIT）。请阅读许可文件以获取详细信息。