snapcx-tracking-client

This is Java bases client library for using snapcx shipping tracking webservice. You can subscribe to tracking webservice (REST based and JSON payload) at https://snapcx.io/pricing. Also read more about this webservice at https://snapcx.io/shippingTracking. Before using this client, you can check your api key using API explorer, running at https://snapcx.io/shippingTrackingAPI

License

License

Categories

Categories

CLI User Interface
GroupId

GroupId

io.snapcx
ArtifactId

ArtifactId

tracking-client
Last Version

Last Version

1.0.1
Release Date

Release Date

Type

Type

jar
Description

Description

snapcx-tracking-client
This is Java bases client library for using snapcx shipping tracking webservice. You can subscribe to tracking webservice (REST based and JSON payload) at https://snapcx.io/pricing. Also read more about this webservice at https://snapcx.io/shippingTracking. Before using this client, you can check your api key using API explorer, running at https://snapcx.io/shippingTrackingAPI
Project URL

Project URL

https://github.com/ajainy/snapcx-tracking-sdk
Project Organization

Project Organization

JFrameworks.com, LLC
Source Code Management

Source Code Management

https://github.com/ajainy/snapcx-tracking-sdk

Download tracking-client

How to add to project

<!-- https://jarcasting.com/artifacts/io.snapcx/tracking-client/ -->
<dependency>
    <groupId>io.snapcx</groupId>
    <artifactId>tracking-client</artifactId>
    <version>1.0.1</version>
</dependency>
// https://jarcasting.com/artifacts/io.snapcx/tracking-client/
implementation 'io.snapcx:tracking-client:1.0.1'
// https://jarcasting.com/artifacts/io.snapcx/tracking-client/
implementation ("io.snapcx:tracking-client:1.0.1")
'io.snapcx:tracking-client:jar:1.0.1'
<dependency org="io.snapcx" name="tracking-client" rev="1.0.1">
  <artifact name="tracking-client" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.snapcx', module='tracking-client', version='1.0.1')
)
libraryDependencies += "io.snapcx" % "tracking-client" % "1.0.1"
[io.snapcx/tracking-client "1.0.1"]

Dependencies

compile (10)

Group / Artifact Type Version
io.swagger : swagger-annotations jar 1.5.9
org.glassfish.jersey.core : jersey-client jar 2.22.2
org.glassfish.jersey.media : jersey-media-multipart jar 2.22.2
org.glassfish.jersey.media : jersey-media-json-jackson jar 2.22.2
com.fasterxml.jackson.core : jackson-core jar 2.7.5
com.fasterxml.jackson.core : jackson-annotations jar 2.7.5
com.fasterxml.jackson.core : jackson-databind jar 2.7.5
com.fasterxml.jackson.datatype : jackson-datatype-joda jar 2.7.5
joda-time : joda-time jar 2.9.4
com.brsanthu : migbase64 jar 2.2

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

snapCX.io Shipping Tracking Java Client

Requirements

Building the API client library requires Maven to be installed.

Installation

To install the API client library to your local Maven repository, simply execute:

mvn install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn deploy

Refer to the official documentation for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
    <groupId>io.snapcx</groupId>
    <artifactId>tracking-client</artifactId>
    <version>1.0.1</version>
    <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "io.snapcx:tracking-client:1.0.1"

Others

At first generate the JAR by executing:

mvn package

Then manually install the following JARs:

  • target/tracking-client-1.0.1.jar
  • target/lib/*.jar

Getting Started

cURL Examples

curl -X GET -H "user_key: 817d94a03dd15c0d5782686aae84974c" "https://api.snapcx.io/tracking/v1/getTrackingDetails?carrier=FEDEX&trackId=074347350384592"

curl -X GET -H "user_key: 817d94a03dd15c0d5782686aae84974c" "https://api.snapcx.io/tracking/v1/getTrackingDetails?carrier=UPS&trackId=1Z884AR10211041421"

Please follow the installation instruction and execute the following Java code:

import io.snapcx.tracking.client.*;
import io.snapcx.tracking.client.auth.*;
import io.snapcx.tracking.client.model.*;
import io.snapcx.tracking.client.api.ShippingApi;

import java.io.File;
import java.util.*;

public class ShippingApiExample {

    public static void main(String[] args) {
        
        ShippingApi apiInstance = new ShippingApi();
        String carrier = "carrier_example"; // String | Shipper Carrier code (UPS or USPS or FEDEX or DHL Or CAN (Canada Post) OR use AUTO for automatic detection.).
        String trackId = "trackId_example"; // String | Carrier tracking number, which is being tracked.
        String userKey = "userKey_example"; // String | Your private key, given after opening account with snapcx.io
        try {
            InlineResponse200 result = apiInstance.getTrackingDetails(carrier, trackId, userKey);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ShippingApi#getTrackingDetails");
            e.printStackTrace();
        }
    }
}

Documentation for API Endpoints

All URIs are relative to https://api.snapcx.io

Class Method HTTP request Description
ShippingApi getTrackingDetails GET /tracking/v1/getTrackingDetails Get Shipping Tracking Details

Documentation for Models

Documentation for Authorization

All endpoints require API KEY in request header. You can get your api key from developer portal of snapcx.io. Name of header key is user_key Example

user_key:d111120ba53b07fxxxx05bc8c754a33f

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issue.

Website

https://snapcx.io

Pricing & Subscription plans

https://snapcx.io/pricing

Contact us

https://snapcx.io/contactus

API Status

https://status.snapcx.io

Troubleshooting and API Explorer

(You can use your API Key to test API end point) https://snapcx.io/shippingTrackingAPI

Versions

Version
1.0.1