Пример для вызовов Box-API

Question

Я использую box-api v1.0 и теперь вижу, что есть новый и хотел бы воспользоваться им. Однако я очень новичок в REST и не понимаю, что здесь делать.

Мой код для получения папки был такой:

wcGetFolders.OpenReadAsync(new Uri("https://www.box.net/api/1.0/rest?action=get_account_tree&api_key=" + api_key + "&auth_token=" + auth_token + "&folder_id=" + currentFolder + "&params[]=onelevel&params[]=nozip")); 

Но теперь с новым API я не уверен, о том, как форматировать строку.

Раньше я был в состоянии установить все параметры внутри uri.

Могу ли я это сделать?

Новый API помощи указывает, что запрос выглядит следующим образом:

https://api.box.com/2.0/folders/FOLDER_ID \ 
-H "Authorization: BoxAuth api_key=API_KEY&auth_token=AUTH_TOKEN" \ 

Я не знаю, что делать с обратной косой черты и кавычки, в основном я не знаю вообще, как форматировать uri, и даже если все -h и т. д. параметры действительно попадают в него вообще.

Answer 1

Примеры запросов в документации приведены для cURL, инструмента командной строки для создания HTTP-запросов, поэтому это относится к примеру.

API-интерфейс v2 API RESTful, который вы можете узнать больше о here и here.

Иными словами, идентификатор папки, в которую вы пытаетесь получить информацию, должен быть вставлен в URL-адрес ресурса, где появляется FOLDER_ID.

Ваш образец кода показывает, что вы работаете в .NET, поэтому я бы рекомендовал использовать одну из библиотек REST для .NET, многие из которых являются which are listed here. Вам также может быть полезно использовать клиент REST, такой как Postman для игры с API.

Answer 2

Проще говоря, просто игнорируйте, как примеры написаны в документации BOX. Им просто нужно было отображать информацию независимо от языка программирования, в этом случае они выбрали синтаксис командной строки.

-H относится к информации заголовка, которую вы будете передавать, когда вы делаете запрос HTTP.

Не знаю, как это было бы в .NET, но в PHP с помощью библиотеки CURL, это было бы что-то вроде этого:

$crl = curl_init(); 

curl_setopt($crl, CURLOPT_URL, 'https://www.box.com/api/2.0/folders/0'); 
curl_setopt($crl, CURLOPT_HTTPHEADER, array('Authorization: BoxAuth api_key=API_KEY&auth_token=AUTH_TOKEN',)); 
curl_setopt($crl, CURLOPT_SSL_VERIFYPEER, false); 
curl_setopt($crl, CURLOPT_RETURNTRANSFER, true); 

$results = curl_exec($crl); 

curl_close($crl);