有人可以帮助解释此示例API调用

Question

长话短说，我正在为Android创建一个Java应用程序，我需要访问USDA的“食品数据中心” api。这是REST api，我正在使用Retrofit来调用API。我试图在文档中找出他们对他们的API的示例调用，但是我对这些API知识很陌生，所以我有点迷茫。

他们将此列为“示例通话”

  

curl -H“ Content-Type：application / json”

     

-X POST

     

-d'{“ generalSearchInput”：“切达干酪”}'

     

https://DEMO_KEY@api.nal.usda.gov/fdc/v1/search

我知道-X表示它是API的后命令，并且我相信-d包含请求参数，但是我完全不知道第一行的含义。您还认为最后一行是标题吗？或标题和端点。非常感谢您的光临。

这是documentation page

的链接

Answer 1

您所拥有的是一个称为curl的工具正在发出的http调用。这只是通过命令行发出http请求的一种方式。最后一行是端点。

这里有一些资源可以帮助您开始使用curl：

• curl的文档页面：https://curl.haxx.se/docs/manpage.html
• 以视频格式解释的卷曲：https://www.youtube.com/watch?v=7XUibDYw4mc

Answer 2

第一行将标头Content-Type设置为值application/json。

POST是http方法。

{"generalSearchInput":"Cheddar cheese"}是请求的正文

最后一行是包含API密钥占位符的URL。

原始请求看起来像

POST /fdc/v1/search HTTP/1.1
Authorization: Basic REVNT19LRVk6
User-Agent: curl/7.29.0
Host: localhost
Accept: */*
Content-Type:application/json
Content-Length: 39

{"generalSearchInput":"Cheddar cheese"}