In this walkthrough you will use the Hoverfly Cloud command line interface, to start a service from the command line. You will then use the Hoverfly Cloud API to modify the behavior of the service.
Last updated
hcc is a multi-purpose command line interface for Hoverfly Cloud. It provides a convenient way to manage your Hoverfly Cloud virtual services and automate their management. Either for ad-hoc actions via the command line or integrated into scripts that are used by Continuous Integration and DevOps tools such as Jenkins.
You can also capture traffic within your network and publish the simulation to your account with hcc. You can read more about that .
The Hoverfly Cloud API provides full control over your services, simulations and scenarios, as well as giving you access to the journal, service statistics and behaviors.
Follow these steps:
Install the CLI for your operating system by following the steps outlined .
Create a simple Hoverfly Simulation with a single endpoint by following step 1 in . Do not create the service, only the simulation.
Once the simulation is created. Navigate back to the .
Follow these steps:
If you followed the previous steps you should have a saved simulation called product-sim. Now we will start a service that uses that simulation.
Execute the following hcc command from the command line to start a service called product with that product-sim simulation.
If you refresh your you will see a new service with the name product starting up.
Test the running service by hitting the single endpoint with your API client: https://product-youraccounthere.hoverfly.io/product/12345
You can remotely manipulate services, simulations and scenarios with hcc, as well as use it as a local proxy to capture local API traffic, or as a local reverse proxy proxying to Hoverfly Cloud. A summary of the commands is as follows:
hcc cannot control all the settings in Hoverfly Cloud however, for that you need to use the REST API directly.
Follow these steps:
Where there are functional limitations with hcc, all functionality available within Hoverfly Cloud can be accessed via the Hoverfly Cloud API.
With the product service running in Hoverfly Cloud, issue the following GET request to the Hoverfly Cloud API to retrieve information about your running service:
https://cloud.hoverfly.io/hoverfly-cloud/api/v1/users/<<user-name>>/hoverflies/product
You will need to add a bearer token containing your API key in a header called Authorization. The API key can be retrieved from your Account page in Hoverfly Cloud.
eg. curl -H "Authorization: Bearer 7254a454c7123454593jgjae06a17025a7" https://cloud.hoverfly.io/hoverfly-cloud/api/v1/users/<<user-name>>/hoverflies/product
You will receive a response similar to this:
While this gives you information about the service, it's status and the simulation it is using, it also give you links to other resources on the Hoverfly Cloud API related to the management of the product service. Let's add some behavior.
Follow these steps:
If you issue a request to the link to the behavior endpoint returned by the query to the service endpoint above, you will receive an error, as there are no configured behaviors as yet for this service. We will add a 40% chance of a 404 Response code and a latency histogram behavior.
Issue the following PUT request with the same Authorization header as before, and with a json Request body as follows:
If successful you should receive a response similar to the below:
Follow these steps:
Refresh the Dashboard
Notice that the product service line now has a magic wand icon. This indicates that behaviors are now in play. Click it to open the behaviors dialogue.
You will notice that the behaviors are configured as set via the API.
Test the running service by hitting the single endpoint with your API client: https://product-youraccounthere.hoverfly.io/product/12345
You should receive Not Found errors 40% of the time and the latency should be noticeable.
Note that the API is extensive and covers all areas of functionality for Hoverfly Cloud. If it can be done through the management portal it can be done through the API.
Follow these steps:
Unless you want to keep the service and simulation, they can be deleted.
To delete the service and it's copy of the simulation navigate to the Dashboard, open the ellipse to the right of the product service that you created, and select Delete.
To delete the master simulation, navigate to the Simulations page, locate the simulation you created, and click the corresponding x at the right of page.
Congratulations! You have completed this Tutorial, "Using the CLI and the Hoverfly Cloud API"
The Hoverfly Cloud API uses hypermedia and resources include links to other related resources in their responses using the format.
