POST JSON Data With Curl

Entering send json data with curl in the AI Command Suggestions will prompt a curl command that can then be quickly inserted in your shell by doing CMD+ENTER .

Sending a JSON payload from a file

To send JSON data from a file instead of the command-line, you can use the following syntax:

$ curl -X POST -H 'Content-Type: application/json' -d @<file> <url>
Run in Warp

Where:

• file is the path to the file containing the JSON payload.

For example, this command will send a request with a JSON payload loaded from the file named data.json located in the current working directory:

$ curl -X POST -H 'Content-Type: application/json' -d @data.json http://example.com
Run in Warp

Handling large JSON payloads

To send large JSON payloads as it, without any character conversion or modification, you can use the --data-binary flag as follows:

$ curl -X POST -H 'Content-Type: application/json' --data-binary @<file> <url>
Run in Warp

Properly formatting the JSON object

Checking the payload format

To make sure that the JSON payload is properly formatted, you can pipe it into the jq command as follows:

$ echo '{"<key>":"<value>", ...}' | jq
$ cat <file> | jq
Run in Warp

The jq command will then parse the data, and either write the JSON object back to the terminal if valid, or output an error message otherwise.

For example:

$ echo '{"hello":"world"}' | jq
{
  "hello": "world"
}
$ echo '{"hello":world}' | jq
jq: parse error: Invalid numeric literal at line 1, column 15
Run in Warp

Escaping special characters in JSON

In JSON, certain characters such as double quotes (") or backslashes () need to be escaped to ensure that the data is correctly formatted and parsed. To escape these characters, you can prepend them with a backslash character.

For example, in the following request, the string h3\o" needs to be escaped as follows:

$ curl -X POST -H 'Content-Type: application/json' -d '{"email":"[email protected]","password":"h3\\o\""}' http://example.com/login
Run in Warp

Specifying the payload’s charset

To prevent encoding issues between the client and the server, you can specify the character set of the HTTP request through the Content-Type header as follows:

$ curl -X POST -H 'Content-Type: application/json; charset=UTF-8' -d <payload> <url>
Run in Warp

Sending authenticated requests

It may sometimes happen that when sending a request to a protected endpoint, the server responds with an HTTP 401 Unauthorized. This means that the request must be authenticated using an access token, usually generated in response to a login request.

To send an authenticated HTTP request containing an access token, you can specify the Authorization header as follows:

$ curl -X POST \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{"<key>":"<value>"}' \
<url>
Run in Warp

For example:

$ curl -X POST \
-H 'Authorization: Bearer a8JxldMFxA' \
-H 'Content-Type: application/json' \
-d '{"":""}' \
http://example.com/
Run in Warp