我使用Ubuntu并在上面安装了cURL。我想用cURL测试我的SpringREST应用程序。我在Java端编写了POST代码。然而,我想用cURL测试它。我正在尝试发布JSON数据。示例数据如下:

{"value":"30","type":"Tip 3","targetModule":"Target 3","configurationGroup":null,"name":"Configuration Deneme 3","description":null,"identity":"Configuration Deneme 3","version":0,"systemId":3,"active":true}

我使用以下命令:

curl -i \
    -H "Accept: application/json" \
    -H "X-HTTP-Method-Override: PUT" \
    -X POST -d "value":"30","type":"Tip 3","targetModule":"Target 3","configurationGroup":null,"name":"Configuration Deneme 3","description":null,"identity":"Configuration Deneme 3","version":0,"systemId":3,"active":true \
    http://localhost:8080/xx/xxx/xxxx

它返回以下错误:

HTTP/1.1 415 Unsupported Media Type
Server: Apache-Coyote/1.1
Content-Type: text/html;charset=utf-8
Content-Length: 1051
Date: Wed, 24 Aug 2011 08:50:17 GMT

错误描述如下:

服务器拒绝了此请求,因为请求实体的格式不受请求方法()的请求资源支持。

Tomcat日志:“POST/ui/webapp/conf/clearHTTP/1.1”415 1051

cURL命令的正确格式是什么?

这是我的Java端PUT代码(我测试过GET和DELETE,它们都有效):

@RequestMapping(method = RequestMethod.PUT)
public Configuration updateConfiguration(HttpServletResponse response, @RequestBody Configuration configuration) { //consider @Valid tag
    configuration.setName("PUT worked");
    //todo If error occurs response.sendError(HttpServletResponse.SC_NOT_FOUND);
    return configuration;
}

您需要将内容类型设置为application/json。但是-d(或--data)发送Content-Type应用程序/x-www-form-urlencoded,这在Spring方面不被接受。

查看curl手册页,我认为可以使用-H(或--header):

-H "Content-Type: application/json"

完整示例:

curl --header "Content-Type: application/json" \
  --request POST \
  --data '{"username":"xyz","password":"xyz"}' \
  http://localhost:3000/api/login

(-H是--header的缩写,-d是--data的缩写)

注意,如果使用-d,-request POST是可选的,因为-d标志表示POST请求。


在Windows上,情况略有不同。请参见注释线程。


尝试将数据放在一个文件中,比如body.json,然后使用

curl -H "Content-Type: application/json" --data @body.json http://localhost:8080/ui/webapp/conf

我也遇到了同样的问题。我可以通过指定

-H "Content-Type: application/json; charset=UTF-8"

你可能会发现resty很有用:

它是CURL的包装器,简化了命令行REST请求。您将其指向API端点,它将为您提供PUT和POST命令(示例改编自主页)。

resty http://127.0.0.1:8080/data #Sets up resty to point at your endpoing
GET /blogs.json                  #Gets http://127.0.0.1:8080/data/blogs.json
                                 #Put JSON
PUT /blogs/2.json '{"id" : 2, "title" : "updated post", "body" : "This is the new."}'
                                 # POST JSON from a file
POST /blogs/5.json < /tmp/blog.json

此外,通常仍然需要添加Content-Type标头。但是,您可以这样做一次,以设置每个站点每个方法添加配置文件的默认值:设置默认RESTY选项


它对我有用,使用:

curl -H "Accept: application/json" -H "Content-type: application/json" -X POST -d '{"id":100}' http://localhost/api/postJsonReader.do

它很高兴地映射到Spring控制器:

@RequestMapping(value = "/postJsonReader", method = RequestMethod.POST)
public @ResponseBody String processPostJsonData(@RequestBody IdOnly idOnly) throws Exception {
        logger.debug("JsonReaderController hit! Reading JSON data!"+idOnly.getId());
        return "JSON Received";
}

IdOnly是一个具有id属性的简单POJO。


这对我来说效果很好,另外还使用了BASIC身份验证:

curl -v --proxy '' --basic -u Administrator:password -X POST -H "Content-Type: application/json"
        --data-binary '{"value":"30","type":"Tip 3","targetModule":"Target 3","configurationGroup":null,"name":"Configuration Deneme 3","description":null,"identity":"Configuration Deneme 3","version":0,"systemId":3,"active":true}'
        http://httpbin.org/post

当然,在没有SSL和已检查证书的情况下,您不应该使用BASIC身份验证。

我今天再次遇到这个问题,使用Cygwin的cURL 7.49.1 for Windows。。。当在JSON参数中使用--data或--data二进制时,cURL会感到困惑,并将JSON中的{}解释为URL模板。添加-g参数以关闭cURL globbing修复了这个问题。

另请参见传递带括号的URL以卷曲。


我使用以下格式在web服务器上进行测试。

use -F 'json data'

让我们假设JSON dict格式:

{
    'comment': {
        'who':'some_one',
        'desc' : 'get it'
    }
}

完整示例

curl -XPOST your_address/api -F comment='{"who":"some_one", "desc":"get it"}'

如果您正在针对RESTful接口测试大量JSON发送/响应,您可能需要查看Postman插件for Chrome(允许您手动定义web服务测试)及其基于Node.js的Newman命令行同伴(允许您针对Postman测试的“集合”自动测试)。免费且开放!


对于Windows,对-d值使用单引号对我来说不起作用,但在更改为双引号后,它确实起了作用。我还需要在大括号内转义双引号。

也就是说,以下操作无效:

curl -i -X POST -H "Content-Type: application/json" -d '{"key":"val"}' http://localhost:8080/appname/path

但以下措施奏效了:

curl -i -X POST -H "Content-Type: application/json" -d "{\"key\":\"val\"}" http://localhost:8080/appname/path

使用CURL Windows,尝试以下操作:

curl -X POST -H "Content-Type:application/json" -d "{\"firstName\": \"blablabla\",\"lastName\": \"dummy\",\"id\": \"123456\"}" http-host/_ah/api/employeeendpoint/v1/employee

这对我来说效果很好。

curl -X POST --data @json_out.txt http://localhost:8080/

哪里

-X表示HTTP动词。

--data表示要发送的数据。


例如,创建一个JSON文件params.JSON,并向其中添加以下内容:

[
    {
        "environment": "Devel",
        "description": "Machine for test, please do not delete!"
    }
]

然后运行以下命令:

curl -v -H "Content-Type: application/json" -X POST --data @params.json -u your_username:your_password http://localhost:8000/env/add_server

这对我有用:

curl -H "Content-Type: application/json" -X POST -d @./my_json_body.txt http://192.168.1.1/json

您还可以将JSON内容放入文件中,并通过标准输入使用--uploadfile选项将其传递给curl,如下所示:

echo 'my.awesome.json.function({"do" : "whatever"})' | curl -X POST "http://url" -T -

您可以使用Postman及其直观的GUI来组装cURL命令。

安装并启动Postman键入您的URL、Post Body、Request Headers等。单击代码从下拉列表中选择cURL复制并粘贴cURL命令

注意:下拉列表中有几个自动生成请求的选项,这就是为什么我认为我的文章首先是必要的。


HTTPie是卷曲的推荐替代品,因为你可以

http POST http://example.com/some/endpoint name=value name1=value1

默认情况下,它使用JSON,并将处理为您设置必要的标头以及将数据编码为有效的JSON。还有:

Some-Header:value

对于标头,以及

name==value

查询字符串参数。如果你有一大块数据,你也可以从一个JSON编码的文件中读取:

field=@file.txt

使用-d选项添加有效负载

curl -X POST \
http://<host>:<port>/<path> \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"foo": "bar",
"lorem": "ipsum"
}'

此外:

使用-X POST使用POST方法

使用-H“Accept:application/json”添加Accept类型头

使用-H“Content-Type:application/json”添加内容类型头


我为此制作了一个叫做“提取器”的工具。它可以发送请求并格式化卷曲片段:

下面是一个示例:

示例输出:

curl -XGET -H "Accept: application/json" -d "{\"value\":\"30\",\"type\":\"Tip 3\",\"targetModule\":\"Target 3\",\"configurationGroup\":null,\"name\":\"Configuration Deneme 3\",\"description\":null,\"identity\":\"Configuration Deneme 3\",\"version\":0,\"systemId\":3,\"active\":true}" "http://localhost:8080/xx/xxx/xxxx"

您可以使用Postman转换为CURL:

注:

最新的邮差版本有一些UI升级,现在代码链接可以在侧边栏中找到。


这在Windows 10上对我有效:

curl -d "{"""owner""":"""sasdasdasdasd"""}" -H "Content-Type: application/json" -X  PUT http://localhost:8080/api/changeowner/CAR4

如果要包含动态数据,这里还有另一种方法。

#!/bin/bash

version=$1
text=$2
branch=$(git rev-parse --abbrev-ref HEAD)
repo_full_name=$(git config --get remote.origin.url | sed 's/.*:\/\/github.com\///;s/.git$//')
token=$(git config --global github.token)

generate_post_data()
{
  cat <<EOF
{
  "tag_name": "$version",
  "target_commitish": "$branch",
  "name": "$version",
  "body": "$text",
  "draft": false,
  "prerelease": false
}
EOF
}

echo "Create release $version for repo: $repo_full_name branch: $branch"
curl --data "$(generate_post_data)" "https://api.github.com/repos/$repo_full_name/releases?access_token=$token"

我的问题是:

卷曲-X POSThttp://your-server-end-point-H“内容类型:application/json”-d@path-of-your-json-file.json

瞧,我做的一切都是对的。只有一件事——我错过了JSON文件路径前面的“@”。

我在互联网上找到了一个相关的文档——通用选项。


根据Anand Rockzz的回答,以下是我在GitHub Actions上对此所做的操作。由于EOF标签,这有点棘手。

我的目标是在Vercel部署完成后发送HTTP调用(类似于webhook)。

这个真实世界的例子可能会帮助其他人。

send-webhook-callback-once-deployment-ready:
  name: Invoke webhook callback url defined by the customer (Ubuntu 18.04)
  runs-on: ubuntu-18.04
  needs: await-for-vercel-deployment
  steps:
    - uses: actions/checkout@v1 # Get last commit pushed - See https://github.com/actions/checkout
    - name: Expose GitHub slug/short variables # See https://github.com/rlespinasse/github-slug-action#exposed-github-environment-variables
      uses: rlespinasse/github-slug-action@v3.x # See https://github.com/rlespinasse/github-slug-action
    - name: Expose git environment variables and call webhook (if provided)
      # Workflow overview:
      #  - Resolves webhook url from customer config file
      #  - If a webhook url was defined, send a
      run: |
        MANUAL_TRIGGER_CUSTOMER="${{ github.event.inputs.customer}}"
        CUSTOMER_REF_TO_DEPLOY="${MANUAL_TRIGGER_CUSTOMER:-$(cat vercel.json | jq --raw-output '.build.env.NEXT_PUBLIC_CUSTOMER_REF')}"

        VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK=$(cat vercel.$CUSTOMER_REF_TO_DEPLOY.staging.json | jq --raw-output '.build.env.VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK')

        # Checking if a webhook url is defined
        if [ -n "$VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK" ]; then
          # Run script that populates git-related variables as ENV variables
          echo "Running script populate-git-env.sh"
          . ./scripts/populate-git-env.sh

          echo "Resolved git variables:"
          echo "'GIT_COMMIT_SHA': $GIT_COMMIT_SHA"
          echo "'GIT_COMMIT_REF': $GIT_COMMIT_REF"
          echo "'GIT_COMMIT_TAGS': $GIT_COMMIT_TAGS"

          # Generates JSON using a bash function - See https://stackoverflow.com/a/57369772/2391795
          # "End Of File" must be at the beginning of the line with no space/tab before or after - See https://stackoverflow.com/a/12909284/2391795
          # But, when executed by GitHub Action, it must be inside the "run" section instead
          generate_post_data() {
            cat <<EOF
          {
            "MANUAL_TRIGGER_CUSTOMER": "${MANUAL_TRIGGER_CUSTOMER}",
            "CUSTOMER_REF": "${CUSTOMER_REF_TO_DEPLOY}",
            "STAGE": "staging",
            "GIT_COMMIT_SHA": "${GIT_COMMIT_SHA}",
            "GIT_COMMIT_REF": "${GIT_COMMIT_REF}",
            "GIT_COMMIT_TAGS": "${GIT_COMMIT_TAGS}",
            "GITHUB_REF_SLUG": "${GITHUB_REF_SLUG}",
            "GITHUB_HEAD_REF_SLUG": "${GITHUB_HEAD_REF_SLUG}",
            "GITHUB_BASE_REF_SLUG": "${GITHUB_BASE_REF_SLUG}",
            "GITHUB_EVENT_REF_SLUG": "${GITHUB_EVENT_REF_SLUG}",
            "GITHUB_REPOSITORY_SLUG": "${GITHUB_REPOSITORY_SLUG}",
            "GITHUB_REF_SLUG_URL": "${GITHUB_REF_SLUG_URL}",
            "GITHUB_HEAD_REF_SLUG_URL": "${GITHUB_HEAD_REF_SLUG_URL}",
            "GITHUB_BASE_REF_SLUG_URL": "${GITHUB_BASE_REF_SLUG_URL}",
            "GITHUB_EVENT_REF_SLUG_URL": "${GITHUB_EVENT_REF_SLUG_URL}",
            "GITHUB_REPOSITORY_SLUG_URL": "${GITHUB_REPOSITORY_SLUG_URL}",
            "GITHUB_SHA_SHORT": "${GITHUB_SHA_SHORT}"
          }
        EOF
          }

          echo "Print generate_post_data():"
          echo "$(generate_post_data)"

          echo "Calling webhook at '$VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK'"
          echo "Sending HTTP request (curl):"
          curl POST \
            "$VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK" \
            -vs \
            --header "Accept: application/json" \
            --header "Content-type: application/json" \
            --data "$(generate_post_data)" \
            2>&1 | sed '/^* /d; /bytes data]$/d; s/> //; s/< //'

          # XXX See https://stackoverflow.com/a/54225157/2391795
          # -vs - add headers (-v) but remove progress bar (-s)
          # 2>&1 - combine stdout and stderr into single stdout
          # sed - edit response produced by curl using the commands below
          #   /^* /d - remove lines starting with '* ' (technical info)
          #   /bytes data]$/d - remove lines ending with 'bytes data]' (technical info)
          #   s/> // - remove '> ' prefix
          #   s/< // - remove '< ' prefix

        else
          echo "No webhook url defined in 'vercel.$CUSTOMER_REF_TO_DEPLOY.staging.json:.build.env.VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK' (found '$VERCEL_DEPLOYMENT_COMPLETED_WEBHOOK')"
        fi

对于我使用过的PowerShell:

curl.exe -H "Content-Type: application/json" --data "@content.json" http://localhost:8080/appname/path

其中content.json是包含请求的本地json文件的名称,curl.exe而不是curl,不使用InvokeWebRequest的别名。

或者如果您想直接指定JSON:

curl.exe -H "Content-Type: application/json" --data '{\"username\":\"xyz\",\"password\":\"xyz\"}' http://localhost:8080/appname/path

-H在标头中发送类似内容类型或身份验证令牌的内容-d此处添加您的数据最后添加站点链接

注意:不要忘记为身份验证凭据添加身份验证令牌(如果有)

curl -X POST -H 'Content-Type: application/json' -H 'Authorization: Token 2de403987713595a7955a9b4655b9e206d4294b3' -d '{"title":"Post test with curl", "body": "test body"}' http://127.0.0.1:8000/api/v1/feeds/

问题在这里:

HTTP/1.1 415 Unsupported Media Type

服务器登录无法解释此请求的媒体类型,因此将其解析为text/html

任何资源的媒体类型都在内容类型中声明请求标头的属性

“接受”。。。header将使该请求失败,因此发送任何JSON请求都需要以下内容,即内容类型

-H 'content-type: application/json'

假设数据和URL类似于

{“电子邮件”:“admin@admin.com“,”密码“:”123456“}

http://localhost:5000/api/login

然后在Linux中

curl  http://localhost:5000/api/login  -H 'content-type: application/json'  -d '{"email": "user@admin.com", "password": "123456"}'

在Windows中(参数周围的单引号不起作用)

curl  http://localhost:5000/api/login  -H "content-type: application/json"  -d "{\"email\": \"user@admin.com\", \"password\": \"123456\"}"

-当命令中存在-d{…..}时,不需要X POST密钥。

对于PUT请求:

-X PUT

TL;博士:

使用神圣的三位一体,jo+curl+jq(或fx):

jo value=30 type="Tip 3" targetModule="Target 3" configurationGroup=null name="Configuration Deneme 3" description=null identity="Configuration Deneme 3" | \
curl --json @- \
    -X POST \
    http://localhost:8080/xx/xxx/xxxx | \
jq

这将涵盖丢失的必要标头:无需显式定义Content-Type和Accept标头。

使用--json的新卷曲方式

2022年3月初,curl发布了一个新的命令行参数——json,版本为7.82.0。这允许通过JSON发送快捷方式,并且无需定义缺少的ContentType和Accept标头,因为这些标头是自动假定的,因此减少了错误风险:

curl --json '{"tool": "curl"}' https://example.com/

但等等。。。还有更多。不要将json参数定义为curl命令行的字符串,而是使用漂亮的joCLI工具将json定义为一系列键-值对,并通过curl管道输出。仅使用jo来定义JSON,其工作方式如下:

 > jo -p value=30 type="Tip 3" targetModule="Target 3" configurationGroup=null name="Configuration Deneme 3" description=null identity="Configuration Deneme 3"
version=0 systemId=3 active=true
{
   "value": 30,
   "type": "Tip 3",
   "targetModule": "Target 3",
   "configurationGroup": null,
   "name": "Configuration Deneme 3",
   "description": null,
   "identity": "Configuration Deneme 3",
   "version": 0,
   "systemId": 3,
   "active": true
}

现在让我们用一个类似的curl命令来展示这一点,但没有额外的头,并使用jo+jq来实现良好的输出:

jo value=30 type="Tip 3" targetModule="Target 3" configurationGroup=null name="Configuration Deneme 3" description=null identity="Configuration Deneme 3" | \
curl --json @- \
    -X POST \
    http://localhost:8080/xx/xxx/xxxx | \
jq

免费API示例

使用免费模拟API进行演示:

> jo title="Blog Post" body="lorem ipsum" userId=33 | \
curl --json @- \
    -X POST \
    https://jsonplaceholder.typicode.com/posts | \
jq

由于jq,输出格式很好:

{
  "title": "Blog Post",
  "body": "lorem ipsum",
  "userId": 33,
  "id": 101
}

您可以通过--dataraw参数将JSON文件的内容分类为curl。

卷曲'https://api.com/route'-H'内容类型:application/json'--数据原始“$(cat~/.json/payload-2022-03-03.json|grep-v'^\s*//')”

注意:JSON文件中的注释通过grep-v“^\s*//”过滤掉

您还可以使用grep或cat通过标准输入将数据传递给curl。

grep-v'^\s*//'~/.json/payload-2022-03-03.json|curl'https://api.com/route'-H'内容类型:application/json'-d@-

cat~/.json/payload-2022-03-03.json|grep-v'^\s*//'|curl'https://api.com/route'-H'内容类型:application/json'-d@-


简单的是

curl -X POST https://localhost:3000/ 
   -H "Content-Type: application/json"
   -d '{"productId": 123456, "quantity": 100}'

--json<data>将POST请求中指定的json数据发送到HTTP服务器。

卷曲7.82.0+

# Send a basic JSON object
curl --json '{"name":"xyz","breed":"xyz","age":100}' http://127.0.0.1:3000/cats

# letter @, read the data from a file
curl --json @cat.txt http://127.0.0.1:3000/cats

# letter -, read the data from stdin
echo '{"name":"xyz","breed":"xyz","age":100}' | curl --json @- http://127.0.0.1:3000/cats

卷曲7.82.0-

curl -X POST --header "Content-Type: application/json" --data '{"name":"xyz","breed":"xyz","age":100}' http://127.0.0.1:3000/cats

https://curl.se/docs/manpage.html#--json文件


以下代码适用于我。

我使用的是示例数据api

curl -X POST --data @json_out.txt https://sampledataapi.com/API/login

这里是解释

-X Means the HTTP verb.
--data Means the data you want to send.