We introduced a new feature to help you quickly explore and learn useful tips and hints on how to become more productive with Restlet Client. It is not easy to find a non intrusive way how to incorporate this into Client. You know, our ultimate goal is to make you more productive, and to make API testing and discovery as easy as possible. So, adding a new tab to the bottom pane was obviously, our first choice. This solution allows you to go over the tips and hints without breaking your workflow, neither does it force you to interrupt what you are doing.
As you can see on the screenshots, all you have to do is switch to the ‘Tips’ pane. Then you can go over the tips and hints by clicking on the arrows placed in middle bottom of the tab.
Or you can just wait a couple of seconds and let the tab switch to a new tip or hint automatically after a few seconds. Of course, you can stop the scrolling by pressing the pause button.
We really hope you find it useful and we are planning to extend a list of tips and hints regularly. And as a reference in case you found a tip to be useful but can’t remember it, we are providing below a list of them.
Share your API projects with ease by simply clicking the three vertical dots button next to a project in your repository and selecting `Share`. The project name changes color once successfully shared.
Never lose your data with cloud synchronization. Go to Settings and enable repository sharing. You can also start repository cloud synchronization manually by clicking on the refresh icon located in the header panel.
You can test the result of a request with assertions. Just save your request and click on the `Add` button in the assertions tab.
API scenarios are chains of interconnected requests. They simplify complex API testing scenarios. Just create a scenario and save your tests there.
Clicking on the name of your scenario in the left panel will show the overview where you can run, re-order, rename and describe your scenario. You can also automate the process by launching your scenarios via the Maven plugin.
You can run your request in different environments with context variables. Open the left tab named `Contexts` and add variables. You can use them in your requests with expressions. Then you just have to switch the selected context to run your requests/scenarios with different variables.
• Visual builder
You can include parts of a request in another, use context variables and/or make your requests dynamic using built-in methods with expressions. To build them easily, you can click on the magic pencil button at the end of an input field or use the `Alt+E` shortcut. The expression will be inserted in your cursor’s position and evaluated when your request is sent.
Expressions allow you to transform data or to interconnect requests/responses. You can easily make a reference on an existing request, a response, or its parts. More information on expressions is available in the user guide.
To edit an expression, click on the magic pencil button at the end of an input field. Your cursor must be on the expression which you want to edit when you click on the button. More information on expressions is available in the user guide.
• Send request
When you are editing a URL, you can send a request by pressing `Alt+Enter`.
Add a header by pressing `Alt+H`.
• Focus HTTP method
Focus HTTP method by pressing `Alt+M`.
• Focus request URI
Focus request URI by pressing `F2`.
• Focus body
Focus request body by pressing `Alt+B`.
• Open expression builder
Open the graphical expression builder by pressing `Alt+E`. You must have your cursor in a field where expressions are allowed and at the position where you want your expression to be inserted.
• Reset request
Reset the current request by pressing `Alt+Backspace`.
• Save request
Save the current request by pressing `Alt+S`.
Shortcuts are configurable, to set your own, just go to Settings in the section named `Shortcuts`.
If you have plenty of requests with assertions. Don’t hesitate to export your repository and use the Maven plugin to make it part of your continuous integration process. More information is available in this video.
• Content type
Click on the content type – JSON, XML … – below the body of your request to switch the syntactic coloring and add the right `Content-type` header.
• Enable expressions
Sometimes you will want to avoid evaluating expressions in the body of your request, either for performance reasons, or the body contains a text that is similar to an expression. You can enable/disable request body evaluation by checking/unchecking the box at the bottom of the body.
• Follow redirects
You can tell Client whether to follow redirects by clicking on the down-facing arrow at the right of the `Send` button. If you want to set the behavior once and for all, go to Settings, and check/uncheck the `Follow redirects` option in the `HTTP` section.
Annoyed by a cache? You can make sure to get a fresh version of the resource every time by checking the cache buster option. It is located in Settings under the section `HTTP`.
• Method bodies
You can customize which HTTP methods have bodies in Settings in the section HTTP.
Some response bodies aren’t displayed the way you’d like them to be? You can customize which format will be applied to a given media type in Settings in the `Appearance` section.
When response payloads contain hyperlinks, Client automatically recognizes those URLs. When you click on them, it will prepare a new request pointing to that URL.
• Basic auth
No need to manually encode your Basic Auth user / password with Base64. Click on `Set an authorization` and Client will do it for you.
You can easily launch your request from a terminal if you have cURL installed. Click on the 2code icon and you will be provided the curl command to copy-paste.