Cloudmersive.®

Getting Started with Cloudmersive and Postman

Step 1 - Import the OpenAPI Specification into Postman

- In Postman click the Import button, or click on File > Import...

- Click on Import From Link

- Paste in the URL from below corresponding to the API that you wish to use from Postman, then click Import.

Image Recognition API

https://api.cloudmersive.com/swagger/api/image

Document and Data Conversion API

https://api.cloudmersive.com/swagger/api/convert

Currency API

https://api.cloudmersive.com/swagger/api/currency

Data Integration API

https://api.cloudmersive.com/swagger/api/dataintegration

OCR API

https://api.cloudmersive.com/swagger/api/ocr

Barcode API

https://api.cloudmersive.com/swagger/api/barcode

NLP API

https://api.cloudmersive.com/swagger/api/nlpv2

Speech API

https://api.cloudmersive.com/swagger/api/speech

Security API

https://api.cloudmersive.com/swagger/api/security

Validate API

https://api.cloudmersive.com/swagger/api/validate

Video and Media Services API

https://api.cloudmersive.com/swagger/api/video

Virus Scan API

https://api.cloudmersive.com/swagger/api/virus

Step 2 - Configure your API Key

Find the API under Collections, and select the API resource you wish to use. Click on Headers and under Apikey paste in your API Key from the Cloudmersive Management Portal into the Value column.

Step 3 - Configure File Parameters

For APIs that upload files, be sure to configure the type of the parameter as a File, as shown here:

Step 4 - Configure Endpoint

By default, when importing the API specs Postman will show the endpoint:

https://api.cloudmersive.com

This is our North America public cloud endpoint. For Private Cloud, Private Tenant Cloud, or Premium customers you can configure your endpoint by clicking on Edit on the collection:

Now, you can set your endpoint under the Variables tab by setting Current Value; for example, in this case we can set a Private Cloud custom endpoint:



We could also set an API Endpoint from the API Endpoints page in the Management Portal.

Step 5 - Try it out

Fill in the other parameters under Body. If a parameter is a file, hover over it, and change its type to File and select the file you wish to upload. When ready, click Send to transmit the API call.