V-Spark Online Help

Obtaining and Using the cURL program

The cURL utility makes it easy to test using the V‑Spark API by providing a simple command-line mechanism for invoking API methods. cURL is not required to use the V‑Spark API, but it can be a helpful tool, even while developing a more programmatic implementation. The next few sections provide examples of using the V‑Spark API from the command line via the cURL command.

The cURL utility is freely available for operating systems including Linux, Windows, and macOS. The command for invoking the cURL utility is curl on Linux or Apple macOS systems. The executable command for invoking the cURL utility is curl.exe on Microsoft Windows systems.

Important

When using cURL to make API calls, it is important to remember that because URLs typically include the '?' and '&' symbols to identify HTTP/HTTPS parameters, you must enclose the URL portion of your cURL command within quotation marks to prevent a Linux shell from intercepting and interpreting these characters.

In cURL examples and associated output that is provided in this document:

  • Escaped newlines (that is, lines in cURL commands or example output that end with a backslash) are added for readability. They must not be present in cURL commands, and are also not present in the output of those commands.

  • Example commands are shown in normal monospaced text. When example output from those commands is very short, it is combined into the same monospaced example block as the cURL call itself and is shown in bold, monospaced text. When example output from examples is verbose, that output is provided as a separate monospace example block.