RajaOngkir Node.js

RajaOngkir Node.js merupakan Node.js Package yang memudahkan pengembang perangkat lunak dalam mengkonsumsi API dari http://rajaongkir.com .

Silahkan baca dokumentasi di bawah ini untuk penggunaan lengkap dari RajaOngkir Node.js.

Daftar Isi

Dokumentasi
Instalasi
Quick Start
Penggunaan
Pengumuman
Cara Kontribusi
Tentang
Lisensi

Dokumentasi

Silahkan buka halaman Wiki untuk dokumentasi penggunaan lengkap dari RajaOngkir Node.js

Instalasi

Prasyarat

Node.js versi 4, 6 atau 7
RajaOngkir Service (telah mendaftar di RajaOngkir.com dengan akun tipe Starter, Basic maupun Pro dan telah memiliki API Key)

Cara Install

Penggunaan Package RajaOngkir Node.js membutuhkan NPM. Jika Anda tidak familiar dengan NPM, Anda dapat membaca NPM Docs terlebih dahulu. Pada dasarnya NPM telah terinstal dengan Node.js sejak node versi 0.8.x karena itu Anda mungkin sudah memilikinya.

Jalankan perintah di bawah ini pada terminal Anda untuk menginstall rajaongkir-nodejs dan menyimpannya di file package.json .

npm install --save rajaongkir-nodejs

Dependencies

Terdapat beberapa Dependency yang mendukung RajaOngkir Node.js dapat berjalan, antara lain :

Main Dependencies

Development Dependencies

Quick Start

Menampilkan Seluruh Provinsi (Starter)

var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');

RajaOngkir.getProvinces().then(function (result){
    // Aksi ketika data Provinsi berhasil ditampilkan
}).catch(function (error){
    // Aksi ketika error terjadi
});

Menampilkan Spesifik Provinsi (Starter)

var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');

var id = 1; // ID Provinsi
RajaOngkir.getProvince(id).then(function (result){
    // Aksi ketika data Provinsi berhasil ditampilkan
}).catch(function (error){
    // Aksi ketika error terjadi
});

Menampilkan Seluruh Kota (Starter)

var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');

RajaOngkir.getCities().then(function (result){
    // Aksi ketika data Kota berhasil ditampilkan
}).catch(function (error){
    // Aksi ketika error terjadi
});

Menghitung Biaya Kirim JNE (Starter)

var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');

var params = {
    origin: 501, // ID Kota atau Kabupaten Asal
    destination: 114, // ID Kota atau Kabupaten Tujuan
    weight: 1700 // Berat Barang dalam gram (gr)
};
RajaOngkir.getJNECost(params).then(function (result){
    // Aksi ketika data Biaya berhasil ditampilkan
}).catch(function (error){
    // Aksi ketika error terjadi
});

Penggunaan

Dalam RajaOngkir Node.js terdapat 3 jenis API yang dapat digunakan yaitu Starter, Basic, dan Pro sesuai dengan dokumentasi RajaOngkir.com. Untuk menjalankan masing - masing API tersebut Anda dapat menggunakan perintah sebagai berikut :

Starter

var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');

Tipe akun Starter memiliki beberapa fitur antara lain :

getProvinces() untuk menampilkan seluruh data Provinsi
getProvince(idProvinsi) untuk menampilkan data Provinsi berdasarkan ID / parameter ID
getCities() untuk menampilkan seluruh data Kota
getCity(idKota) untuk menampilkan data Kota berdasarkan ID / Parameter ID
getJNECost(params) untuk menampilkan biaya pengiriman Kurir JNE
getPOSCost(params) untuk menampilkan biaya pengiriman Kurir POS
getTIKICost(params) untuk menampilkan biaya pengiriman Kurir TIKI

Basic

var RajaOngkir = require('rajaongkir-nodejs').Basic('apiKey');

Tipe akun Basic memiliki beberapa fitur antara lain :

getProvinces() untuk menampilkan seluruh data Provinsi
getProvince(idProvinsi) untuk menampilkan data Provinsi berdasarkan ID / parameter ID
getCities() untuk menampilkan seluruh data Kota
getCity(idKota) untuk menampilkan data Kota berdasarkan ID / Parameter ID
getJNECost(params) untuk menampilkan biaya pengiriman Kurir JNE
getPOSCost(params) untuk menampilkan biaya pengiriman Kurir POS
getTIKICost(params) untuk menampilkan biaya pengiriman Kurir TIKI
getRPXCost(params) untuk menampilkan biaya pengiriman Kurir RPX
getESLCost(params) untuk menampilkan biaya pengiriman Kurir ESL
getPCPCost(params) untuk menampilkan biaya pengiriman Kurir PCP
getInterOrigins() untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional
getInterOrigin(idKota) untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional berdasarkan ID Kota/Kabupaten
getInterDests() untuk menampilkan data Negara yang mendukung pengiriman internasional
getInterDest(idNegara) untuk menampilkan data Negara yang mendukung pengiriman internasional berdasarkan ID Negara
getTIKIInterConst(params) untuk menampilkan biaya pengiriman internasional melalui kurir TIKI
getPOSInterCost(params) untuk menampilkan biaya pengiriman internasional melalui kurir POS
getCurrency() untuk menampilkan informasi nilai tukar rupiah terhadap US dollar
getJNEWaybill(params) untuk melacak / mengetahui status pengiriman berdasarkan nomor resi JNE

Pro

var RajaOngkir = require('rajaongkir-nodejs').Pro('apiKey');

Tipe akun Basic memiliki beberapa fitur antara lain :

getProvinces() untuk menampilkan seluruh data Provinsi
getProvince(idProvinsi) untuk menampilkan data Provinsi berdasarkan ID / parameter ID
getCities() untuk menampilkan seluruh data Kota
getCity(idKota) untuk menampilkan data Kota berdasarkan ID / Parameter ID
getCosts(params) untuk menampilkan biaya pengiriman dari beberapa layanan pengiriman (kurir)
getJNECost(params) untuk menampilkan biaya pengiriman Kurir JNE
getPOSCost(params) untuk menampilkan biaya pengiriman Kurir POS
getTIKICost(params) untuk menampilkan biaya pengiriman Kurir TIKI
getRPXCost(params) untuk menampilkan biaya pengiriman Kurir RPX
getESLCost(params) untuk menampilkan biaya pengiriman Kurir ESL
getPCPCost(params) untuk menampilkan biaya pengiriman Kurir PCP
getInterOrigins() untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional
getInterOrigin(idKota) untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional berdasarkan ID Kota/Kabupaten
getInterDests() untuk menampilkan data Negara yang mendukung pengiriman internasional
getInterDest(idNegara) untuk menampilkan data Negara yang mendukung pengiriman internasional berdasarkan ID Negara
getTIKIInterConst(params) untuk menampilkan biaya pengiriman internasional melalui kurir TIKI
getPOSInterCost(params) untuk menampilkan biaya pengiriman internasional melalui kurir POS
getCurrency() untuk menampilkan informasi nilai tukar rupiah terhadap US dollar
getJNEWaybill(params) untuk melacak / mengetahui status pengiriman berdasarkan nomor resi JNE

Pengumuman

RajaOngkimumr Node.js masih dalam tahap pengembangan, mungkin semua fitur tidak tercover atau masih terdapat Bug dalam penggunaan API RajaOngkir.com

Cara Kontribusi

Saya sangat menghargai setiap kontribusi Anda dalam pengembangan Package RajaOngkir Node.js.

Anda dapat Melaporkan issue (Kesalahan Program, Saran, dll) dengan membuat New Issue melalui halaman Issue
Anda juga dapat berkontribusi untuk Package ini dengan cara Pull Request

Tentang

RajaOngkir NodeJS merupakan Package Node.js yang dapat digunakan oleh pengembang perangkat lunak dalam mengkonsumsi API http://rajaongkir.com . RajaOngkir Node.js merupakan Unofficial Package yang dikembangkan oleh pihak eksternal RajaOngkir.com. Package ini masih dalam tahap pengembangan dan mungkin terjadi beberapa error dalam penggunaanya.

Info lebih lanjut Anda dapat menghubungi Andhika Maheva Wicaksono melalui email [email protected].

Lisensi

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

andhikamaheva / rajaongkir-nodejs Goto Github PK