Client for URLs (or cURL) is a software project comprised of two development efforts - cURL and libcurl.
CURL is a tool for data transfer. It is also available as a library for developers and as a CLI for terminal-based use cases. Both have the same engine inside (Truth is that CLI tool is just the program that uses the library under the hood). Section 6-1: Curl and Divergence. Before we can get into surface integrals we need to get some introductory material out of the way. That is the purpose of the first two sections of this chapter. In this section we are going to introduce the concepts of the curl and the divergence of a vector. Let’s start with the curl. Here’s how you can do it using curl command and its telnet functionality. Test SSH port connection with curl. In this example, SSH connection works because: We get the “Connected” status; We see the SSH version prompt: SSH-2.0-OpenSSH7.4. Is the home of this book. It features accessible links to read the book online in a web version, or download a PDF version for offline reading. Unfortunately, the previously provided ebook formats are no longer provided by gitbook.com that we use to produce the book. What is cURL, and what does it do? CURL is a tool to transfer data from or to a server, using one of the many supported protocols (HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, DICT, TELNET, LDAP or FILE).
libcurl is a free, client-side URL transfer library with support for a wide range of protocols. libcurl is portable, thread-safe, feature rich, and well supported on virtually any platform. It is probably the most popular C-based, multi-platform file transfer library in use.
cURL is a command-line tool for getting or sending files using URL syntax. Since cURL uses libcurl, it supports the same range of common Internet protocols that libcurl does.
This tutorial will walk through the format and syntax used when making Oracle Eloqua API requests with cURL. If you are not yet familiar with the structure of requests, see API requests.
In this tutorial:
Note: The code samples in this tutorial are developed for bash. See cURL request formatting for more information on how to structure cURL requests for other command line tools.
Authentication
The easiest way to authenticate with Oracle Eloqua's APIs is to use basic authentication which uses your Eloqua company name, user name, and password to authenticate. To use basic authentication, use the cURL --user option followed by your company name and user name as the value. cURL will then prompt you for your password.
To avoid the password prompt, append your password after your user name by following the syntax --user '<companyName><userName>:<password>', but this will leave your password in shell history and isn't recommended.
Note: For this tutorial, the company name we use is APITest, our user name is API.User, and our pod is 3.
Sending a GET request
Let's retrieve the first two contacts within your database. Only the --user option is required. The --request option is optional, but we include it in the example below for conformity with other requests to establish a pattern.
Sending a DELETE request
Curl Get-pip
For DELETE requests, the --user option and --request option are both required. Let's delete a contact whose contact id is 1.
Note that for DELETE requests, there is no body is returned, just a response status code.
Sending a POST request
POST requests are a little different. Let's look at an example of how to create a contact whose email address is 'george.washington@america.com'.
As you can see POST requests are much different than the other verbs we've looked at so far, so let's take a closer look at what's happening in the request.
- The
--headeroption is required with aContent-Type. AllPOSTandPUTrequests to the Application and Cloud APIs should beapplication/json, while the Bulk API supportsapplication/jsonandtext/csv. To confirm the media types supported, see the 'Supported Media Types' per endpoint in our endpoint documentation. - The
--dataoption is optional, but we include it for readability.
Sending a PUT request
Curl Get Status Code
PUT requests follow the same format as POST requests. Let's take a look at an example of how to update a contact to change the contact's business phone number when the contact id is 1 and email address is 'george.washington@america.com'.
Curl Get With Parameters
Learn more