Authentication

Making an API Call

12min

Overview

Here you will find out how to make API calls with your access token. The access token is always required for calling any of our APIs.

The following is the successful response body that you will get.

JSON
ο»Ώ

Steps

The following is a step-by-step instruction on calling the Container Tracking API endpoint in Postman.

Making an API call
Making an API call
ο»Ώ

Note:

To import Rippey AI Postman Collection, please refer to the Postman Collection section.

Step 1: Select the Authenticate Endpoint

Navigate to Collection > Track and Trace > auth >login.

Document image
ο»Ώ

ο»Ώ

Step 2: Set the Authenticate Body

Generate an access token with the Authenticate POST method. Set the body with your key and secret.

Document image
ο»Ώ

Step 3: Press the Send button

Press the Send button to call the authenticate API.

Document image
ο»Ώ

Below is the success response containing your access token.

Document image
ο»Ώ

Note:

Go here to know more detail about the Authenticate endpoint.

Step 4: Add Authorization Header

Document image
ο»Ώ

Step 5: Subscribe to the cargo

Navigate to Collection > Track and Trace > Air | Ocean > subscribe air waybill | container

Do not forget to add the Authorization header [See step 4]

Document image
ο»Ώ

Step 6: Select the Tracking Endpoint

Navigate to Collection > Track and Trace > Air | Ocean > get air waybills | containers

Do not forget to add the Authorization header [See step 4]

Document image
ο»Ώ

Step 7: Set the Params

Set which container you want to track in the query parameters.

Document image
ο»Ώ

Step 8: Retrieve the Response

Now you are ready to call the GET Container Tracking API. Hit the Send button.

Document image
ο»Ώ

βœ…Done! You will get the container information details as seen in the example below.

200 OK
ο»Ώ

🚩 If you get an unsuccessful response, please see the Error Handling section to figure out how to handle the errors.

βœ‰οΈ Need some help?

If you encounter a problem or require assistance, please contact our support team with details regarding your request at [email protected]. A representative will connect with you soon. 😊

Updated 25 Mar 2024
Doc contributor
Doc contributor
Doc contributor
Doc contributor
Doc contributor
Did this page help you?