new-rajaongkir 0.0.2 → 0.0.5

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 -25
  3. package/README.md +241 -241
  4. package/appveyor.yml +17 -17
  5. package/index.js +1 -1
  6. package/lib/rajaongkir/index.js +9 -20
  7. package/lib/rajaongkir/pro/index.js +45 -1104
  8. package/package.json +51 -50
  9. package/test/basic.js +255 -255
  10. package/test/pro.js +776 -776
  11. package/test/starter.js +118 -118
  12. package/lib/rajaongkir/basic/index.js +0 -376
  13. package/lib/rajaongkir/starter/index.js +0 -155
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,25 +1,25 @@
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.
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,241 +1,241 @@
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
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')
package/lib/rajaongkir/index.js CHANGED
@@ -1,20 +1,9 @@
1
- var Starter = require('./starter'),
2
- Basic = require('./basic'),
3
- Pro = require('./pro'),
4
- fs = require('fs')
5
-
6
- module.exports = {
7
- Starter: function (apiKey) {
8
- if (!apiKey) throw new Error('You must provide RajaOngkir API key')
9
- return new Starter(apiKey)
10
- },
11
- Basic: function (apiKey) {
12
- if (!apiKey) throw new Error('You must provide RajaOngkir API key')
13
- return new Basic(apiKey)
14
- },
15
- Pro: function (apiKey) {
16
- if (!apiKey) throw new Error('You must provide RajaOngkir API key')
17
- return new Pro(apiKey)
18
- }
19
-
20
- }
1
+ var Pro = require('./pro'),
2
+ fs = require('fs')
3
+
4
+ module.exports = {
5
+ Pro: function (apiKey) {
6
+ if (!apiKey) throw new Error('You must provide RajaOngkir API key')
7
+ return new Pro(apiKey)
8
+ }
9
+ }