Demo environment

The Container Tracking API demo environment is meant to be used as a testing or staging grounds for getting started or evaluating Vizion's track and trace service. The demo environment (demo.vizionapi.com) has a limit of 50 active references.

Each API key is allowed 15,000 calls, or requests, to the demo environment on a monthly basis. Other than the above differences, the demo environment functions similarly to the production environment.

🚧

Limit reset

Please note this limit reset happens on the third of the month.

Intended use

We view the testing process as beginning with creating several references using one of the POST methods, such as the Create Reference via Carrier Code endpoint, to test tracking containers for carriers that your business or customers regularly use.

Once a reference exists, you can use the following API endpoints to view the appropriate responses:

• Show Reference Details endpoint
• List Active References endpoint
• List Reference Updates endpoint

If you are subscribed to Vizion's Pro plan, we also recommending testing the List Container Trace endpoint.

Once you've tested creating your references and taken all desired actions against those references, we recommend that you de-activate them all (or the ones that are no longer necessary) by using the Unsubscribe Reference endpoint to free up space again.

Remember - the API environments are separate

The demo environment of the Vizion API functions exactly the same as the production environment in terms of creating references, viewing their details, retrieving or receiving reference updates, etc. While the demo environment might receive bug fixes or new features shortly before those changes are pushed to the production environment, testing on the demo environment is meant to effectively mirror the same behavior as tracking live data on the production environment.

However, the references that you create on one environment are not available on the other environment. If you attempt to fetch updates on the demo environment for a reference that you created on the production environment, this will not work as your references are directly linked to the environment in which they were created.

If you create a reference on the demo environment, you will need to continue using the demo environment in order to interact further with that reference. The same is also rue for the production environment.

Increasing reference limit

To keep the performance of the demo environment as stable as possible, raising the limit is not recommended. The limit ensures that the resources being allocated to the demo environment stay within a comfortable boundary for every user.