Может кто-нибудь помочь объяснить этот пример вызова API

Question

Короче говоря, я создаю Java-приложение для Android, и мне нужно получить доступ к API "Food Data Central" USDA. Это 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 означает, что это команда post для API, и я полагаю, что -d содержит параметры запроса, но я полностью потерян относительно первой строкиозначает. Также вы думаете, что последняя строка является заголовком? или заголовок и конечная точка. Большое спасибо за поиск.

Вот ссылка на страницу документации

Answer 1

То, что у вас есть, это http-вызов, выполняемый инструментом curl. Это просто способ сделать http-запросы через командную строку. Последняя строка - это конечная точка.

Вот несколько ресурсов для начала работы с curl:

• Страница документа для curl: https://curl.haxx.se/docs/manpage.html
• Curl поясняется в видеоформате: https://www.youtube.com/watch?v=7XUibDYw4mc

Answer 2

Первая строка устанавливает заголовок Content-Type в значение application/json.

POST - это метод http.

{"generalSearchInput":"Cheddar cheese"} - это тело запроса

Последняя строка - это URL-адрес, содержащий заполнитель для ключа API.

Необработанный запрос будет выглядеть как

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"}