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

• fs
• http
• request
• promise
• querystring

Development Dependencies

• assert
• chai
• coveralls
• istanbul
• mocha
• mocha-lcov-reporter
• nock
• vows
• standard

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

Copyright (c) 2017 Andhika Maheva Wicaksono

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.