new-rajaongkir 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/.travis.yml +14 -14
  2. package/LICENSE +25 -21
  3. package/README.md +241 -237
  4. package/appveyor.yml +17 -17
  5. package/index.js +1 -1
  6. package/lib/rajaongkir/basic/index.js +376 -376
  7. package/lib/rajaongkir/index.js +20 -20
  8. package/lib/rajaongkir/pro/index.js +303 -1038
  9. package/lib/rajaongkir/starter/index.js +155 -155
  10. package/package.json +51 -50
  11. package/test/basic.js +255 -255
  12. package/test/pro.js +776 -776
  13. package/test/starter.js +118 -118
package/.travis.yml CHANGED
@@ -1,14 +1,14 @@
1
- language: node_js
2
- node_js:
3
- - 4
4
- - 6
5
- - 7
6
- before_install:
7
- - npm install
8
- script:
9
- - npm test
10
- - npm run test-ci
11
- after_script: npm install coveralls@2.10.0 && cat ./coverage/lcov.info | coveralls
12
- env:
13
- global:
14
- - secure: "nRTDzmE+x1ux0+Dg+rhgcSGECE60VgkIKIfrFoP+L4qzU0aXTqtY+w5IJcNrDGreRFx/AO7wG0zpNp4OZ+o7EfR1qyCcF+LKQS43IMa0+vO2u48Fw6+VDwglJ+ZYFU+/lT1RcPZgoDYi/OPk3VcIl9aVncvKEGvq/JOCH2vvThPD84nXiHjWKizOr41vqIlcUaykmmWwHwGdXmg/hIeCO76GHfc5O7JwmFNAT4HoVmYJpGyjyKX4olQ1IOfloiDKRk05OTyI3G+Q0k26IzYeNNHDIxmfX5epkMu75wJ5t0D/gfW4T8WY8HM3n/mbJFO5tuimlbtPZor7sIUWsh+VO5E3fz0eka8HpqK35Tck5a776HEz6hDOD3d/D5tWkLQ+H4u2yh8tdYS0cxLF3gkjh6g9oLR4GQ1VMzmNdR49CMGLYaBQkhLBi4+K2Jo8J/0G15P+FFZVBIdCriV6NnOEGTwYwnnq/Bv1OFzapPwZajb9esBkhit5+tw8AO8oq8/T8SI+6AUFxX+H7coGtDRB6r3muRLwyepwwiJIRP15cKQNWHL4yHzYEgBQIkCXN1IkInz4mN33+r8FMeqHMaHA4e4d4YRatiz+CESbvVS61vg1kmgu5VGwnKikxhEpnUIzDvkDCM1fqYUfdZ5pBj9UmtRutBbwuJ0XTORAunobebw="
1
+ language: node_js
2
+ node_js:
3
+ - 4
4
+ - 6
5
+ - 7
6
+ before_install:
7
+ - npm install
8
+ script:
9
+ - npm test
10
+ - npm run test-ci
11
+ after_script: npm install coveralls@2.10.0 && cat ./coverage/lcov.info | coveralls
12
+ env:
13
+ global:
14
+ - secure: "nRTDzmE+x1ux0+Dg+rhgcSGECE60VgkIKIfrFoP+L4qzU0aXTqtY+w5IJcNrDGreRFx/AO7wG0zpNp4OZ+o7EfR1qyCcF+LKQS43IMa0+vO2u48Fw6+VDwglJ+ZYFU+/lT1RcPZgoDYi/OPk3VcIl9aVncvKEGvq/JOCH2vvThPD84nXiHjWKizOr41vqIlcUaykmmWwHwGdXmg/hIeCO76GHfc5O7JwmFNAT4HoVmYJpGyjyKX4olQ1IOfloiDKRk05OTyI3G+Q0k26IzYeNNHDIxmfX5epkMu75wJ5t0D/gfW4T8WY8HM3n/mbJFO5tuimlbtPZor7sIUWsh+VO5E3fz0eka8HpqK35Tck5a776HEz6hDOD3d/D5tWkLQ+H4u2yh8tdYS0cxLF3gkjh6g9oLR4GQ1VMzmNdR49CMGLYaBQkhLBi4+K2Jo8J/0G15P+FFZVBIdCriV6NnOEGTwYwnnq/Bv1OFzapPwZajb9esBkhit5+tw8AO8oq8/T8SI+6AUFxX+H7coGtDRB6r3muRLwyepwwiJIRP15cKQNWHL4yHzYEgBQIkCXN1IkInz4mN33+r8FMeqHMaHA4e4d4YRatiz+CESbvVS61vg1kmgu5VGwnKikxhEpnUIzDvkDCM1fqYUfdZ5pBj9UmtRutBbwuJ0XTORAunobebw="
package/LICENSE CHANGED
@@ -1,21 +1,25 @@
1
- MIT License
2
-
3
- Copyright (c) 2017 Andhika Maheva Wicaksono
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ <<<<<<< HEAD
4
+ Copyright (c) 2025 Asiadev Media
5
+ =======
6
+ Copyright (c) 2017 Andhika Maheva Wicaksono
7
+ >>>>>>> master
8
+
9
+ Permission is hereby granted, free of charge, to any person obtaining a copy
10
+ of this software and associated documentation files (the "Software"), to deal
11
+ in the Software without restriction, including without limitation the rights
12
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13
+ copies of the Software, and to permit persons to whom the Software is
14
+ furnished to do so, subject to the following conditions:
15
+
16
+ The above copyright notice and this permission notice shall be included in all
17
+ copies or substantial portions of the Software.
18
+
19
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25
+ SOFTWARE.
package/README.md CHANGED
@@ -1,237 +1,241 @@
1
- # RajaOngkir Node.js
2
-
3
- [![NPM Version][npm-image]][npm-url] [![NPM Downloads][downloads-image]][downloads-url] [![Linux Build][build-image]][build-url] [![Windows Build][appveyor-image]][appveyor-url] [![Coverage Status][coveralls-image]][coveralls-url] [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
4
-
5
- RajaOngkir Node.js merupakan Node.js Package yang memudahkan pengembang perangkat lunak dalam mengkonsumsi API dari http://rajaongkir.com .
6
-
7
- Silahkan baca dokumentasi di bawah ini untuk penggunaan lengkap dari RajaOngkir Node.js.
8
-
9
- # Daftar Isi
10
-
11
- * [Dokumentasi](#documentation)
12
- * [Instalasi](#installation)
13
- * [Quick Start](#quick_start)
14
- * [Penggunaan](#usage)
15
- * [Pengumuman](#announcements)
16
- * [Cara Kontribusi](#contribute)
17
- * [Tentang](#about)
18
- * [Lisensi](#license)
19
-
20
- <a name="documentation"></a>
21
- # Dokumentasi
22
- Silahkan buka halaman [Wiki](https://github.com/andhikamaheva/rajaongkir-nodejs/wiki) untuk dokumentasi penggunaan lengkap dari RajaOngkir Node.js
23
-
24
-
25
- <a name="installation"></a>
26
- # Instalasi
27
-
28
- ## Prasyarat
29
- - Node.js versi 4, 6 atau 7
30
- - RajaOngkir Service (telah mendaftar di RajaOngkir.com dengan akun tipe Starter, Basic maupun Pro dan telah memiliki **API Key**)
31
-
32
- ## Cara Install
33
- Penggunaan Package RajaOngkir Node.js membutuhkan [NPM](https://npmjs.org/). Jika Anda tidak familiar dengan NPM, Anda dapat membaca [NPM Docs](https://npmjs.org/doc/) terlebih dahulu.
34
- Pada dasarnya NPM telah terinstal dengan Node.js sejak node versi 0.8.x karena itu Anda mungkin sudah memilikinya.
35
-
36
- Jalankan perintah di bawah ini pada terminal Anda untuk menginstall <code>rajaongkir-nodejs</code> dan menyimpannya di file <code>package.json</code> .
37
- ```bash
38
- npm install --save rajaongkir-nodejs
39
- ```
40
-
41
- ## Dependencies
42
- Terdapat beberapa Dependency yang mendukung RajaOngkir Node.js dapat berjalan, antara lain :
43
-
44
- ### Main Dependencies
45
- * [fs](https://nodejs.org/api/fs.html)
46
- * [http](https://www.npmjs.com/package/http)
47
- * [request](https://github.com/request/request)
48
- * [promise](https://github.com/then/promise)
49
- * [querystring](https://github.com/Gozala/querystring)
50
-
51
-
52
- ### Development Dependencies
53
- * [assert](https://github.com/defunctzombie/commonjs-assert)
54
- * [chai](https://github.com/chaijs/chai)
55
- * [coveralls](https://github.com/nickmerwin/node-coveralls)
56
- * [istanbul](https://github.com/gotwarlost/istanbul)
57
- * [mocha](https://github.com/mochajs/mocha)
58
- * [mocha-lcov-reporter](https://github.com/StevenLooman/mocha-lcov-reporter)
59
- * [nock](https://github.com/node-nock/nock)
60
- * [vows](https://github.com/vowsjs/vows)
61
- * [standard](https://github.com/standard/standard)
62
-
63
- <a name="quick_start"></a>
64
- # Quick Start
65
-
66
- ### Menampilkan Seluruh Provinsi (Starter)
67
- ```javascript
68
- var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
69
-
70
- RajaOngkir.getProvinces().then(function (result){
71
- // Aksi ketika data Provinsi berhasil ditampilkan
72
- }).catch(function (error){
73
- // Aksi ketika error terjadi
74
- });
75
- ```
76
-
77
- ### Menampilkan Spesifik Provinsi (Starter)
78
- ```javascript
79
- var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
80
-
81
- var id = 1; // ID Provinsi
82
- RajaOngkir.getProvince(id).then(function (result){
83
- // Aksi ketika data Provinsi berhasil ditampilkan
84
- }).catch(function (error){
85
- // Aksi ketika error terjadi
86
- });
87
- ```
88
- ### Menampilkan Seluruh Kota (Starter)
89
- ```javascript
90
- var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
91
-
92
- RajaOngkir.getCities().then(function (result){
93
- // Aksi ketika data Kota berhasil ditampilkan
94
- }).catch(function (error){
95
- // Aksi ketika error terjadi
96
- });
97
- ```
98
-
99
- ### Menghitung Biaya Kirim JNE (Starter)
100
- ```javascript
101
- var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
102
-
103
- var params = {
104
- origin: 501, // ID Kota atau Kabupaten Asal
105
- destination: 114, // ID Kota atau Kabupaten Tujuan
106
- weight: 1700 // Berat Barang dalam gram (gr)
107
- };
108
- RajaOngkir.getJNECost(params).then(function (result){
109
- // Aksi ketika data Biaya berhasil ditampilkan
110
- }).catch(function (error){
111
- // Aksi ketika error terjadi
112
- });
113
- ```
114
-
115
- <a name="usage"></a>
116
- # Penggunaan
117
- Dalam RajaOngkir Node.js terdapat 3 jenis API yang dapat digunakan yaitu **Starter, Basic, dan Pro** sesuai dengan [dokumentasi](http://rajaongkir.com/dokumentasi) RajaOngkir.com.
118
- Untuk menjalankan masing - masing API tersebut Anda dapat menggunakan perintah sebagai berikut :
119
-
120
- ### Starter
121
- ```javascript
122
- var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
123
- ```
124
- Tipe akun **Starter** memiliki beberapa fitur antara lain :
125
- * <code>getProvinces()</code> untuk menampilkan seluruh data Provinsi
126
- * <code>getProvince(idProvinsi)</code> untuk menampilkan data Provinsi berdasarkan ID / parameter ID
127
- * <code>getCities()</code> untuk menampilkan seluruh data Kota
128
- * <code>getCity(idKota)</code> untuk menampilkan data Kota berdasarkan ID / Parameter ID
129
- * <code>getJNECost(params)</code> untuk menampilkan biaya pengiriman Kurir JNE
130
- * <code>getPOSCost(params)</code> untuk menampilkan biaya pengiriman Kurir POS
131
- * <code>getTIKICost(params)</code> untuk menampilkan biaya pengiriman Kurir TIKI
132
-
133
-
134
- ### Basic
135
- ```javascript
136
- var RajaOngkir = require('rajaongkir-nodejs').Basic('apiKey');
137
- ```
138
- Tipe akun **Basic** memiliki beberapa fitur antara lain :
139
- * <code>getProvinces()</code> untuk menampilkan seluruh data Provinsi
140
- * <code>getProvince(idProvinsi)</code> untuk menampilkan data Provinsi berdasarkan ID / parameter ID
141
- * <code>getCities()</code> untuk menampilkan seluruh data Kota
142
- * <code>getCity(idKota)</code> untuk menampilkan data Kota berdasarkan ID / Parameter ID
143
- * <code>getJNECost(params)</code> untuk menampilkan biaya pengiriman Kurir JNE
144
- * <code>getPOSCost(params)</code> untuk menampilkan biaya pengiriman Kurir POS
145
- * <code>getTIKICost(params)</code> untuk menampilkan biaya pengiriman Kurir TIKI
146
- * <code>getRPXCost(params)</code> untuk menampilkan biaya pengiriman Kurir RPX
147
- * <code>getESLCost(params)</code> untuk menampilkan biaya pengiriman Kurir ESL
148
- * <code>getPCPCost(params)</code> untuk menampilkan biaya pengiriman Kurir PCP
149
- * <code>getInterOrigins()</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional
150
- * <code>getInterOrigin(idKota)</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional berdasarkan ID Kota/Kabupaten
151
- * <code>getInterDests()</code> untuk menampilkan data Negara yang mendukung pengiriman internasional
152
- * <code>getInterDest(idNegara)</code> untuk menampilkan data Negara yang mendukung pengiriman internasional berdasarkan ID Negara
153
- * <code>getTIKIInterConst(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir TIKI
154
- * <code>getPOSInterCost(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir POS
155
- * <code>getCurrency()</code> untuk menampilkan informasi nilai tukar rupiah terhadap US dollar
156
- * <code>getJNEWaybill(params)</code> untuk melacak / mengetahui status pengiriman berdasarkan nomor resi JNE
157
-
158
- ### Pro
159
- ```javascript
160
- var RajaOngkir = require('rajaongkir-nodejs').Pro('apiKey');
161
- ```
162
- Tipe akun **Basic** memiliki beberapa fitur antara lain :
163
- * <code>getProvinces()</code> untuk menampilkan seluruh data Provinsi
164
- * <code>getProvince(idProvinsi)</code> untuk menampilkan data Provinsi berdasarkan ID / parameter ID
165
- * <code>getCities()</code> untuk menampilkan seluruh data Kota
166
- * <code>getCity(idKota)</code> untuk menampilkan data Kota berdasarkan ID / Parameter ID
167
- * <code>getJNECost(params)</code> untuk menampilkan biaya pengiriman Kurir JNE
168
- * <code>getPOSCost(params)</code> untuk menampilkan biaya pengiriman Kurir POS
169
- * <code>getTIKICost(params)</code> untuk menampilkan biaya pengiriman Kurir TIKI
170
- * <code>getRPXCost(params)</code> untuk menampilkan biaya pengiriman Kurir RPX
171
- * <code>getESLCost(params)</code> untuk menampilkan biaya pengiriman Kurir ESL
172
- * <code>getPCPCost(params)</code> untuk menampilkan biaya pengiriman Kurir PCP
173
- * <code>getInterOrigins()</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional
174
- * <code>getInterOrigin(idKota)</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional berdasarkan ID Kota/Kabupaten
175
- * <code>getInterDests()</code> untuk menampilkan data Negara yang mendukung pengiriman internasional
176
- * <code>getInterDest(idNegara)</code> untuk menampilkan data Negara yang mendukung pengiriman internasional berdasarkan ID Negara
177
- * <code>getTIKIInterConst(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir TIKI
178
- * <code>getPOSInterCost(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir POS
179
- * <code>getCurrency()</code> untuk menampilkan informasi nilai tukar rupiah terhadap US dollar
180
- * <code>getJNEWaybill(params)</code> untuk melacak / mengetahui status pengiriman berdasarkan nomor resi JNE
181
-
182
- <a name="announcements"></a>
183
- # Pengumuman
184
- RajaOngkimumr Node.js masih dalam tahap pengembangan, mungkin semua fitur tidak tercover atau masih terdapat Bug dalam penggunaan API RajaOngkir.com
185
-
186
- <a name="contribute"></a>
187
- # Cara Kontribusi
188
- Saya sangat menghargai setiap kontribusi Anda dalam pengembangan Package RajaOngkir Node.js.
189
- * Anda dapat Melaporkan issue (Kesalahan Program, Saran, dll) dengan membuat **New Issue** melalui halaman [Issue](https://github.com/andhikamaheva/rajaongkir-nodejs/issues)
190
- * Anda juga dapat berkontribusi untuk Package ini dengan cara [Pull Request](https://github.com/andhikamaheva/rajaongkir-nodejs/pulls)
191
-
192
-
193
- <a name="about"></a>
194
- # Tentang
195
- 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.
196
- Package ini masih dalam tahap pengembangan dan mungkin terjadi beberapa error dalam penggunaanya.
197
-
198
- Info lebih lanjut Anda dapat menghubungi Andhika Maheva Wicaksono melalui email [andhikamaheva@gmail.com](mailto:andhikamaheva@gmail.com).
199
-
200
-
201
-
202
- <a name="license"></a>
203
- # Lisensi
204
-
205
- **MIT License**
206
-
207
- Copyright (c) 2017 Andhika Maheva Wicaksono
208
-
209
- Permission is hereby granted, free of charge, to any person obtaining a copy
210
- of this software and associated documentation files (the "Software"), to deal
211
- in the Software without restriction, including without limitation the rights
212
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
213
- copies of the Software, and to permit persons to whom the Software is
214
- furnished to do so, subject to the following conditions:
215
-
216
- The above copyright notice and this permission notice shall be included in all
217
- copies or substantial portions of the Software.
218
-
219
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
220
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
221
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
222
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
223
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
224
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
225
- SOFTWARE.
226
-
227
- [build-image]: https://img.shields.io/travis/andhikamaheva/rajaongkir-nodejs/master.svg?label=linux
228
- [build-url]: https://travis-ci.org/andhikamaheva/rajaongkir-nodejs
229
- [npm-image]: https://badge.fury.io/js/rajaongkir-nodejs.svg
230
- [npm-url]: https://badge.fury.io/js/rajaongkir-nodejs
231
- [downloads-image]: https://img.shields.io/npm/dm/rajaongkir-nodejs.svg
232
- [downloads-url]: https://npmjs.org/package/rajaongkir-nodejs
233
- [appveyor-image]: https://img.shields.io/appveyor/ci/andhikamaheva/rajaongkir-nodejs/master.svg?label=windows
234
- [appveyor-url]: https://ci.appveyor.com/project/andhikamaheva/rajaongkir-nodejs
235
- [coveralls-image]: https://coveralls.io/repos/github/andhikamaheva/rajaongkir-nodejs/badge.svg?branch=master
236
- [coveralls-url]: https://coveralls.io/github/andhikamaheva/rajaongkir-nodejs?branch=master
237
-
1
+ # new-rajaongkir
2
+ NodeJS Client Library API RajaOngkir
3
+ =======
4
+ # RajaOngkir Node.js
5
+
6
+ [![NPM Version][npm-image]][npm-url] [![NPM Downloads][downloads-image]][downloads-url] [![Linux Build][build-image]][build-url] [![Windows Build][appveyor-image]][appveyor-url] [![Coverage Status][coveralls-image]][coveralls-url] [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
7
+
8
+ RajaOngkir Node.js merupakan Node.js Package yang memudahkan pengembang perangkat lunak dalam mengkonsumsi API dari http://rajaongkir.com .
9
+
10
+ Silahkan baca dokumentasi di bawah ini untuk penggunaan lengkap dari RajaOngkir Node.js.
11
+
12
+ # Daftar Isi
13
+
14
+ * [Dokumentasi](#documentation)
15
+ * [Instalasi](#installation)
16
+ * [Quick Start](#quick_start)
17
+ * [Penggunaan](#usage)
18
+ * [Pengumuman](#announcements)
19
+ * [Cara Kontribusi](#contribute)
20
+ * [Tentang](#about)
21
+ * [Lisensi](#license)
22
+
23
+ <a name="documentation"></a>
24
+ # Dokumentasi
25
+ Silahkan buka halaman [Wiki](https://github.com/andhikamaheva/rajaongkir-nodejs/wiki) untuk dokumentasi penggunaan lengkap dari RajaOngkir Node.js
26
+
27
+
28
+ <a name="installation"></a>
29
+ # Instalasi
30
+
31
+ ## Prasyarat
32
+ - Node.js versi 4, 6 atau 7
33
+ - RajaOngkir Service (telah mendaftar di RajaOngkir.com dengan akun tipe Starter, Basic maupun Pro dan telah memiliki **API Key**)
34
+
35
+ ## Cara Install
36
+ Penggunaan Package RajaOngkir Node.js membutuhkan [NPM](https://npmjs.org/). Jika Anda tidak familiar dengan NPM, Anda dapat membaca [NPM Docs](https://npmjs.org/doc/) terlebih dahulu.
37
+ Pada dasarnya NPM telah terinstal dengan Node.js sejak node versi 0.8.x karena itu Anda mungkin sudah memilikinya.
38
+
39
+ Jalankan perintah di bawah ini pada terminal Anda untuk menginstall <code>rajaongkir-nodejs</code> dan menyimpannya di file <code>package.json</code> .
40
+ ```bash
41
+ npm install --save rajaongkir-nodejs
42
+ ```
43
+
44
+ ## Dependencies
45
+ Terdapat beberapa Dependency yang mendukung RajaOngkir Node.js dapat berjalan, antara lain :
46
+
47
+ ### Main Dependencies
48
+ * [fs](https://nodejs.org/api/fs.html)
49
+ * [http](https://www.npmjs.com/package/http)
50
+ * [request](https://github.com/request/request)
51
+ * [promise](https://github.com/then/promise)
52
+ * [querystring](https://github.com/Gozala/querystring)
53
+
54
+
55
+ ### Development Dependencies
56
+ * [assert](https://github.com/defunctzombie/commonjs-assert)
57
+ * [chai](https://github.com/chaijs/chai)
58
+ * [coveralls](https://github.com/nickmerwin/node-coveralls)
59
+ * [istanbul](https://github.com/gotwarlost/istanbul)
60
+ * [mocha](https://github.com/mochajs/mocha)
61
+ * [mocha-lcov-reporter](https://github.com/StevenLooman/mocha-lcov-reporter)
62
+ * [nock](https://github.com/node-nock/nock)
63
+ * [vows](https://github.com/vowsjs/vows)
64
+ * [standard](https://github.com/standard/standard)
65
+
66
+ <a name="quick_start"></a>
67
+ # Quick Start
68
+
69
+ ### Menampilkan Seluruh Provinsi (Starter)
70
+ ```javascript
71
+ var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
72
+
73
+ RajaOngkir.getProvinces().then(function (result){
74
+ // Aksi ketika data Provinsi berhasil ditampilkan
75
+ }).catch(function (error){
76
+ // Aksi ketika error terjadi
77
+ });
78
+ ```
79
+
80
+ ### Menampilkan Spesifik Provinsi (Starter)
81
+ ```javascript
82
+ var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
83
+
84
+ var id = 1; // ID Provinsi
85
+ RajaOngkir.getProvince(id).then(function (result){
86
+ // Aksi ketika data Provinsi berhasil ditampilkan
87
+ }).catch(function (error){
88
+ // Aksi ketika error terjadi
89
+ });
90
+ ```
91
+ ### Menampilkan Seluruh Kota (Starter)
92
+ ```javascript
93
+ var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
94
+
95
+ RajaOngkir.getCities().then(function (result){
96
+ // Aksi ketika data Kota berhasil ditampilkan
97
+ }).catch(function (error){
98
+ // Aksi ketika error terjadi
99
+ });
100
+ ```
101
+
102
+ ### Menghitung Biaya Kirim JNE (Starter)
103
+ ```javascript
104
+ var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
105
+
106
+ var params = {
107
+ origin: 501, // ID Kota atau Kabupaten Asal
108
+ destination: 114, // ID Kota atau Kabupaten Tujuan
109
+ weight: 1700 // Berat Barang dalam gram (gr)
110
+ };
111
+ RajaOngkir.getJNECost(params).then(function (result){
112
+ // Aksi ketika data Biaya berhasil ditampilkan
113
+ }).catch(function (error){
114
+ // Aksi ketika error terjadi
115
+ });
116
+ ```
117
+
118
+ <a name="usage"></a>
119
+ # Penggunaan
120
+ Dalam RajaOngkir Node.js terdapat 3 jenis API yang dapat digunakan yaitu **Starter, Basic, dan Pro** sesuai dengan [dokumentasi](http://rajaongkir.com/dokumentasi) RajaOngkir.com.
121
+ Untuk menjalankan masing - masing API tersebut Anda dapat menggunakan perintah sebagai berikut :
122
+
123
+ ### Starter
124
+ ```javascript
125
+ var RajaOngkir = require('rajaongkir-nodejs').Starter('apiKey');
126
+ ```
127
+ Tipe akun **Starter** memiliki beberapa fitur antara lain :
128
+ * <code>getProvinces()</code> untuk menampilkan seluruh data Provinsi
129
+ * <code>getProvince(idProvinsi)</code> untuk menampilkan data Provinsi berdasarkan ID / parameter ID
130
+ * <code>getCities()</code> untuk menampilkan seluruh data Kota
131
+ * <code>getCity(idKota)</code> untuk menampilkan data Kota berdasarkan ID / Parameter ID
132
+ * <code>getJNECost(params)</code> untuk menampilkan biaya pengiriman Kurir JNE
133
+ * <code>getPOSCost(params)</code> untuk menampilkan biaya pengiriman Kurir POS
134
+ * <code>getTIKICost(params)</code> untuk menampilkan biaya pengiriman Kurir TIKI
135
+
136
+
137
+ ### Basic
138
+ ```javascript
139
+ var RajaOngkir = require('rajaongkir-nodejs').Basic('apiKey');
140
+ ```
141
+ Tipe akun **Basic** memiliki beberapa fitur antara lain :
142
+ * <code>getProvinces()</code> untuk menampilkan seluruh data Provinsi
143
+ * <code>getProvince(idProvinsi)</code> untuk menampilkan data Provinsi berdasarkan ID / parameter ID
144
+ * <code>getCities()</code> untuk menampilkan seluruh data Kota
145
+ * <code>getCity(idKota)</code> untuk menampilkan data Kota berdasarkan ID / Parameter ID
146
+ * <code>getJNECost(params)</code> untuk menampilkan biaya pengiriman Kurir JNE
147
+ * <code>getPOSCost(params)</code> untuk menampilkan biaya pengiriman Kurir POS
148
+ * <code>getTIKICost(params)</code> untuk menampilkan biaya pengiriman Kurir TIKI
149
+ * <code>getRPXCost(params)</code> untuk menampilkan biaya pengiriman Kurir RPX
150
+ * <code>getESLCost(params)</code> untuk menampilkan biaya pengiriman Kurir ESL
151
+ * <code>getPCPCost(params)</code> untuk menampilkan biaya pengiriman Kurir PCP
152
+ * <code>getInterOrigins()</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional
153
+ * <code>getInterOrigin(idKota)</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional berdasarkan ID Kota/Kabupaten
154
+ * <code>getInterDests()</code> untuk menampilkan data Negara yang mendukung pengiriman internasional
155
+ * <code>getInterDest(idNegara)</code> untuk menampilkan data Negara yang mendukung pengiriman internasional berdasarkan ID Negara
156
+ * <code>getTIKIInterConst(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir TIKI
157
+ * <code>getPOSInterCost(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir POS
158
+ * <code>getCurrency()</code> untuk menampilkan informasi nilai tukar rupiah terhadap US dollar
159
+ * <code>getJNEWaybill(params)</code> untuk melacak / mengetahui status pengiriman berdasarkan nomor resi JNE
160
+
161
+ ### Pro
162
+ ```javascript
163
+ var RajaOngkir = require('rajaongkir-nodejs').Pro('apiKey');
164
+ ```
165
+ Tipe akun **Basic** memiliki beberapa fitur antara lain :
166
+ * <code>getProvinces()</code> untuk menampilkan seluruh data Provinsi
167
+ * <code>getProvince(idProvinsi)</code> untuk menampilkan data Provinsi berdasarkan ID / parameter ID
168
+ * <code>getCities()</code> untuk menampilkan seluruh data Kota
169
+ * <code>getCity(idKota)</code> untuk menampilkan data Kota berdasarkan ID / Parameter ID
170
+ * <code>getJNECost(params)</code> untuk menampilkan biaya pengiriman Kurir JNE
171
+ * <code>getPOSCost(params)</code> untuk menampilkan biaya pengiriman Kurir POS
172
+ * <code>getTIKICost(params)</code> untuk menampilkan biaya pengiriman Kurir TIKI
173
+ * <code>getRPXCost(params)</code> untuk menampilkan biaya pengiriman Kurir RPX
174
+ * <code>getESLCost(params)</code> untuk menampilkan biaya pengiriman Kurir ESL
175
+ * <code>getPCPCost(params)</code> untuk menampilkan biaya pengiriman Kurir PCP
176
+ * <code>getInterOrigins()</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional
177
+ * <code>getInterOrigin(idKota)</code> untuk menampilkan data Kota (asal pengiriman) yang tersedia untuk pengiriman internasional berdasarkan ID Kota/Kabupaten
178
+ * <code>getInterDests()</code> untuk menampilkan data Negara yang mendukung pengiriman internasional
179
+ * <code>getInterDest(idNegara)</code> untuk menampilkan data Negara yang mendukung pengiriman internasional berdasarkan ID Negara
180
+ * <code>getTIKIInterConst(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir TIKI
181
+ * <code>getPOSInterCost(params)</code> untuk menampilkan biaya pengiriman internasional melalui kurir POS
182
+ * <code>getCurrency()</code> untuk menampilkan informasi nilai tukar rupiah terhadap US dollar
183
+ * <code>getJNEWaybill(params)</code> untuk melacak / mengetahui status pengiriman berdasarkan nomor resi JNE
184
+
185
+ <a name="announcements"></a>
186
+ # Pengumuman
187
+ RajaOngkimumr Node.js masih dalam tahap pengembangan, mungkin semua fitur tidak tercover atau masih terdapat Bug dalam penggunaan API RajaOngkir.com
188
+
189
+ <a name="contribute"></a>
190
+ # Cara Kontribusi
191
+ Saya sangat menghargai setiap kontribusi Anda dalam pengembangan Package RajaOngkir Node.js.
192
+ * Anda dapat Melaporkan issue (Kesalahan Program, Saran, dll) dengan membuat **New Issue** melalui halaman [Issue](https://github.com/andhikamaheva/rajaongkir-nodejs/issues)
193
+ * Anda juga dapat berkontribusi untuk Package ini dengan cara [Pull Request](https://github.com/andhikamaheva/rajaongkir-nodejs/pulls)
194
+
195
+
196
+ <a name="about"></a>
197
+ # Tentang
198
+ 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.
199
+ Package ini masih dalam tahap pengembangan dan mungkin terjadi beberapa error dalam penggunaanya.
200
+
201
+ Info lebih lanjut Anda dapat menghubungi Andhika Maheva Wicaksono melalui email [andhikamaheva@gmail.com](mailto:andhikamaheva@gmail.com).
202
+
203
+
204
+
205
+ <a name="license"></a>
206
+ # Lisensi
207
+
208
+ **MIT License**
209
+
210
+ Copyright (c) 2017 Andhika Maheva Wicaksono
211
+
212
+ Permission is hereby granted, free of charge, to any person obtaining a copy
213
+ of this software and associated documentation files (the "Software"), to deal
214
+ in the Software without restriction, including without limitation the rights
215
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
216
+ copies of the Software, and to permit persons to whom the Software is
217
+ furnished to do so, subject to the following conditions:
218
+
219
+ The above copyright notice and this permission notice shall be included in all
220
+ copies or substantial portions of the Software.
221
+
222
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
223
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
224
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
225
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
226
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
227
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
228
+ SOFTWARE.
229
+
230
+ [build-image]: https://img.shields.io/travis/andhikamaheva/rajaongkir-nodejs/master.svg?label=linux
231
+ [build-url]: https://travis-ci.org/andhikamaheva/rajaongkir-nodejs
232
+ [npm-image]: https://badge.fury.io/js/rajaongkir-nodejs.svg
233
+ [npm-url]: https://badge.fury.io/js/rajaongkir-nodejs
234
+ [downloads-image]: https://img.shields.io/npm/dm/rajaongkir-nodejs.svg
235
+ [downloads-url]: https://npmjs.org/package/rajaongkir-nodejs
236
+ [appveyor-image]: https://img.shields.io/appveyor/ci/andhikamaheva/rajaongkir-nodejs/master.svg?label=windows
237
+ [appveyor-url]: https://ci.appveyor.com/project/andhikamaheva/rajaongkir-nodejs
238
+ [coveralls-image]: https://coveralls.io/repos/github/andhikamaheva/rajaongkir-nodejs/badge.svg?branch=master
239
+ [coveralls-url]: https://coveralls.io/github/andhikamaheva/rajaongkir-nodejs?branch=master
240
+
241
+ >>>>>>> master
package/appveyor.yml CHANGED
@@ -1,18 +1,18 @@
1
- environment:
2
- matrix:
3
- - nodejs_version: "4.8"
4
- - nodejs_version: "5.12"
5
- - nodejs_version: "6.11"
6
- - nodejs_version: "7.10"
7
- cache:
8
- - node_modules
9
- install:
10
- - ps: Install-Product node $env:nodejs_version
11
- - if exist node_modules npm prune
12
- - if exist node_modules npm rebuild
13
- - npm install
14
- build: off
15
- test_script:
16
- - node --version
17
- - npm --version
1
+ environment:
2
+ matrix:
3
+ - nodejs_version: "4.8"
4
+ - nodejs_version: "5.12"
5
+ - nodejs_version: "6.11"
6
+ - nodejs_version: "7.10"
7
+ cache:
8
+ - node_modules
9
+ install:
10
+ - ps: Install-Product node $env:nodejs_version
11
+ - if exist node_modules npm prune
12
+ - if exist node_modules npm rebuild
13
+ - npm install
14
+ build: off
15
+ test_script:
16
+ - node --version
17
+ - npm --version
18
18
  version: "{build}"
package/index.js CHANGED
@@ -1 +1 @@
1
- module.exports = require('./lib/rajaongkir')
1
+ module.exports = require('./lib/rajaongkir')