Skip to content

HTTP Teststep

An HTTP Teststep allows you to send a HTTP request for several HTTP methods such as GET, POST and PUT. Additionally, you may send JSON in the HTTP-Body.

See Create HTTP Teststep, to add a new HTTP Teststep for a testcase

The screenshot contain sample URLs from the ITunes store, provided on iTunes Search API Documentation Archive

Please don't understand these screenshots as any kind of endorsement from Apple® for this software.

HTTP teststep tab request url only edit mode

Request overview

The Request editor provides four tabs, we will cover these in the order they appear on the screen.

Request (Tab)

  • URL: Enter the URL that you want to test against.

  • URL edit mode: There are three url edit modes available. We will cover these below

    • Selected HTTP Teststep The HTTP Teststep editor appears, when you select an HTTP Teststep in the teststep list

    • Run URL request Press this button to send yor URL request to the URL

    • Response viewer: This viewer displays the JSON content and may be empty, if no content is returned from the server.

URL edit mode

There are three url edit modes:

  • URL as a single String:

You enter the full url including host, port, route and query parameters, this is the default

  • URL with separate list of query parameters: You have separate input fields for schema, host, port, route and an editable list of query parameters

  • URL with separate list for route parameters and query parameters: You have separate input fields for schema, host, port and editable lists of route parameters and query parameters

Configure your request

HTTP Teststep configuration

The HTTP teststep configuration allows you the select the HTTP method and the authentication method (none, basic authentication and bearer authentication).

Supported HTTP methods

            - GET
            - POST
            - PUT
            - DELETE
            - HEAD
            - PATCH

Supported MIME content types for POST and PUT

            - application/json
            - text/xml
            - application/soap+xml

resolvedRequest (Tab)

This viewer show the request with resolved variable values

Header fields

This view displays the HTTP headers used for the URL request. You may create your custom set of HTTP headers for test reasons.

HTTP Teststep header fields configuration

  • use manual header fields: Set the toggle to true, to override the automatic header field configuration.

  • Add new HTTP Header: Creates a new header. There is no automatic check for duplicate names, use the Button check for duplicates to perform this check.

  • check for duplicates: Header fields names must be unique, If you use manual header fields, press this button to check for duplicates

  • arbitrary selection to remove elements: You can select arbitrary elements to remove these.

  • remove selected elements: Press this button to remove the selected elements. This has only an effect, if you use manual headers.

Assertion list

Assertions help you to assess the validity of a teststeps output. APIJockey TEST provides a set of assertions types depending on the output type unter test.

We discuss the list buttons in the order they appear in the view from left to right

  • Create new HTTP assertion.
  • Create new JSON assertion with JSONPath.
  • Create new Image Assertion.
  • Create new PDF Assertion.
  • Delete selected Assertion(s)
  • Rename selected Assertion
  • Move up selection in the list
  • Move down selection in the list
  • Enable/disable: An assertion will only be executed, if it is enabled. A disabled assertion appears with grey text color.

  • Run (selected assertion or all assertion): This button runs all selected elements in the order they appear. If no assertion is selected, the whole list will be run.

  • List of assertions with current result status

  • Displays the name of the assertion and the result status

Copy and Paste

A context menu provides Pasteboard operations for:

  • cut
  • copy
  • paste
  • duplicate