# Postman collections

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

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

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-70e7a9942e6bd753eeb3b70db1fd11c46b387d65%2F190509A_iSHARE_Test_Environment.postman_environment.json?alt=media>" %}
Environment
{% endfile %}

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-8a42fdefd77504d81c291c1dd0ae235feb953c7c%2F190312A_iSHARE_Globals.postman_globals.json?alt=media>" %}
Globals
{% endfile %}

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-a4c39b9bd11bbee3fe6fa9b1cb260b3564a125fe%2F13feb2024_iSHARE_satellite_PIR_Test.postman_collection.json?alt=media>" %}
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="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-4ef18ba01431e662d50c1d4e3f96c7109b67ae87%2F190509A_iSHARE_Test_-_ABC_Trucking_and_Warehouse13.postman_collection.json?alt=media>" %}
ABC Trucking and Warehouse 13 Postman collection
{% endfile %}

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-b8c3b13c546670d8150faeb01aba85fae8911ce9%2F190312A_iSHARE_Test_-_ABC_Trucking_and_Authorization_Registry.postman_collection.json?alt=media>" %}
ABC Trucking and the Authorization Registry Postman collection
{% endfile %}

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-80e61c9552888ac6269cecb932bcabebb9cab215%2F190312A_iSHARE_Test_-_ABC_Trucking_and_Awesome_Widgets.postman_collection.json?alt=media>" %}
ABC Trucking and Awesome Widgets Postman collection
{% endfile %}

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-8419eb88cf860e2f33e75742337c31d9eed73d3c%2F190509A_iSHARE_E2E-_M2M_1a__SP_requests_DE_.postman_collection.json?alt=media>" %}
End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Provider requests Delegation Evidence) Postman collection
{% endfile %}

{% file src="<https://3767213106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKoAebnZrQmvS4VqGwQk%2Fuploads%2Fgit-blob-8a42bcfa551688b348f159e628ca169691a1f7d3%2F190509A_iSHARE_E2E-_M2M_1b__SC_provides_DE_.postman_collection.json?alt=media>" %}
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 %}

### 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, 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="success" %}
**Tip**

For /delegation service requests please view the demo in the [video section](https://gitlab.com/ishare-foundation/cab/developer-portal/-/blob/v2.0.1/reference/broken-reference/README.md), this will explain how authorization in iSHARE can work and Postman examples are shown.
{% endhint %}