Testing Using Postman

Before using Postman, the DITA Merge REST server must be first setup and run, see The REST Server

Postman is a popular web development and testing tool for working with APIs and can be downloaded from https://www.getpostman.com/

It provides easy access to the APIs to perform merge operations using your licensed products.

Postman provides extensive features for performing integration testing with our API. It allows for repeatable, reliable tests that can be automated and used  in a variety of environments and includes useful tools for persisting data. See the Postman Learning Centre.

A collection is available for testing using Postman. Click this button to import the Collection to Postman:

After importing, the collection is available from the sidebar under "Collections":

The Collection comes with various example requests, these have been set up with Collection specific variables - "scheme", "host", and "port" as shown in the URL below.

These three variables have the respective default values of httplocalhost, and 8080

If you need to change these, then click the "..." button in the sidebar next to the Collection name, then "Edit". Note that the Variables tab is only available for the Collection not the individual requests.

From "Variables" you can then edit as required, for example if the REST service is running over a different port than 8080:

Example Responses

Some requests also have example responses (available under the "Examples" dropdown in the top-right) - showing you the sort of HTTP response you can expect from the service. The examples are also documented in the API documentation hosted by Postman here https://documenter.getpostman.com/view/5865356/SVSGPW3r

#content .code