Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

israel-postal-service-api

3.0.2 • Public • Published

Israel Postal Service API

An API for Israel postal service - query shipment price easily. Supports both NodeJS and browser environments.

licence npm version Dependencies status Documentation



Installation

npm install --save israel-postal-service-api

Usage

Import library:

import { IPS, Options } from 'israel-postal-service-api';

Define Package Characteristics:

// define package shipment characteristics
let weightInGrams = 20;
let serviceType = Options.AbroadMailOptions.LETTER.shipmentType;
let serviceSubtype = Options.AbroadMailOptions.LETTER.shipmentSubtypes.regular;
let option = serviceSubtype.options.signed;
 
// initialize service
let postalService = new IPS();

Calculate Shipping Rate:

// calculate package shipping rate asynchronously
let response = await postalService.calculateAbroadShippingRate(
    "Spain", weightInGrams, serviceType, serviceSubtype, option);
 
// see {@class ResponseParser} API to discover the response structure
console.log(response.getTotalPrice()); 

Supported Environments

  • 💻 Browser (including browserify / webpack based environments [such as Angular])
  • 🖥 Node.js

Documentation

Support

If you're having any problem, please raise an issue on GitHub and we'll be happy to help.

Contribute

Before submitting a pull request, please make sure that you include tests, and that jshint runs without any warnings: Download VSCode extension.

Test

Run the test suite by executing:

$ npm test

Note: This API was create as an open source service for makers and entrepreneurs. This is not an official API for Israel Post service.

Author: Benny Megidish.

Install

npm i israel-postal-service-api

DownloadsWeekly Downloads

6

Version

3.0.2

License

Apache-2.0

Unpacked Size

145 kB

Total Files

31

Last publish

Collaborators

  • avatar