# Postman collections

{% hint style="warning" %}
These Postman collections are compatible with iSHARE 2.0. An updated version will be available and published here soon.
{% endhint %}

This section contains various Postman collections, which can be used to manually test iSHARE APIs. In these collections, you, as a user, are impersonating Test participant ‘ABC Trucking’.

In order to impersonate ABC Trucking, these Postman collections contain the private key of ABC Trucking. For non-dummy parties, private keys should never be shared with the Scheme Owner or other iSHARE Parties

Each collection contains all API endpoints of a specific Test participant, and as ABC Trucking, you are able to consume these API endpoints.

### Downloads

For the collections to work, please download iSHARE `environment` and `globals`. Then download the following Postman collections:

{% file src="/files/ZGRhVrR5P3ZpTitXcq7U" %}
End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Consumer provides Delegation Evidence) (Service Provider requests Delegation Evidence) Postman collection
{% endfile %}

{% file src="/files/O0m8Air1ut4sN1eb8bwg" %}
End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Provider requests Delegation Evidence) Postman collection
{% endfile %}

{% file src="/files/CvCLqW9RafsUzu13quaW" %}
ABC Trucking and Awesome Widgets Postman collection
{% endfile %}

{% file src="/files/hxiR39NbLqNydXcdEPik" %}
ABC Trucking and the Authorization Registry Postman collection
{% endfile %}

{% file src="/files/wkneDFTjTpruj7j2Lk5m" %}
ABC Trucking and Warehouse 13 Postman collection
{% endfile %}

{% file src="/files/QxrJmNP9TMzzFPKWhtNr" %}
ABC Trucking and the Satellite (from iSHARE Trust Framework version 2.x onwards)and its related [`environment`](https://dev.ishare.eu/_downloads/ca3b072f85efad28432ec31bb8689eb9/13feb2024_iSHARE_satellite_PIR_Test_env.postman_collection.json)
{% endfile %}

{% file src="/files/vrAd1q2IIcFtZPxJjaIA" %}
Globals
{% endfile %}

{% file src="/files/cXWA5DaW6gzMcry7yRhY" %}
Environment
{% endfile %}

### Instructions

To request an access token:

* Open the /token request
* The client\_assertion is generated in the background
* Run the request without making additional changes, and the response should contain (among others) an access token value

To request a service:

* Open a service request
* The access token is automatically copied.
* Run the request, the response should contain (an encoded) response
* If the response is encoded, decode the token via [jwt.io](https://www.jwt.io/) and inspect the results

{% hint style="info" %}
There is a Walkthrough of the Postman Collection in the [Trust Body of Knowledge](https://trustbok.ishare.eu/apply-ishare/quick-walkthroughs/postman-collections).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.ishare.eu/introduction/getting-started/postman-collections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.