Welcome!

The C++ REST SDK is a Microsoft project for cloud-based client-server communication in native code using a modern asynchronous C++ API design. This project aims to help C++ developers connect to and interact with services.

Getting Started

With vcpkg on Windows

PS> vcpkg install cpprestsdk cpprestsdk:x64-windows
 

With apt-get on Debian/Ubuntu

$ sudo apt-get install libcpprest-dev

With brew on OSX

$ brew install cpprestsdk

With NuGet on Windows for Android

PM> Install-Package cpprestsdk.android

For other platforms, install options, how to build from source, and more, take a look at our Documentation.

Once you have the library, look at our tutorial to use the http_client. It walks through how to setup a project to use the C++ Rest SDK and make a basic Http request.

To use from CMake:

cmake_minimum_required(VERSION 3.7)
project(main)

find_package(cpprestsdk REQUIRED)

add_executable(main main.cpp)
target_link_libraries(main PRIVATE cpprestsdk::cpprest)
 

What‘s in the SDK:

• Features - HTTP client/server, JSON, URI, asynchronous streams, WebSockets client, oAuth
• PPL Tasks - A powerful model for composing asynchronous operations based on C++ 11 features
• Platforms - Windows desktop, Windows Store (UWP), Linux, OS X, Unix, iOS, and Android
• Support for Visual Studio 2015 and 2017 with debugger visualizers

Contribute Back!

Is there a feature missing that you‘d like to see, or found a bug that you have a fix for? Or do you have an idea or just interest in helping out in building the library? Let us know and we‘d love to work with you. For a good starting point on where we are headed and feature ideas, take a look at our requested features and bugs.

Big or small we‘d like to take your contributions back to help improve the C++ Rest SDK for everyone. If interested contact us askcasablanca at Microsoft dot com.

Having Trouble?

We‘d love to get your review score, whether good or bad, but even more than that, we want to fix your problem. If you submit your issue as a Review, we won‘t be able to respond to your problem and ask any follow-up questions that may be necessary. The most efficient way to do that is to open a an issue in our issue tracker.

Quick Links

• FAQ
• Documentation
• Issue Tracker
• Directly contact us: [email protected]

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

安裝微軟的開源 cpprestsdk （C++ REST SDK (codename "Casablanca")），要先有項目；這裏新建一個WIN32控制臺項目，名為XXX，默認使用系統生成的代碼；

然後打開：VS2013 -> 工具 ->庫程序包管理器->程序包管理器控制臺

輸入 ：

install-package cpprestsdk

等待安裝完畢；

或者慢的話，到 https://www.nuget.org/packages?q=cpprestsdk.v120

手動把這幾個包下載下來（點擊進去，點download）放到緩存目錄： C:\Users\Administrator\AppData\Local\NuGet\Cache

再執行 install-package cpprestsdk

等待安裝

顯示

。。。

已成功將“cpprestsdk 2.9.1.1”添加到 xxx （你新建的項目名），則安裝成功。

把main文件所在的代碼替換成下面例子的代碼：

1. // xx.cpp : 定義控制臺應用程序的入口點。
2. //
4. #include "stdafx.h"
6. /*
7. int _tmain(int argc, _TCHAR* argv[])
8. {
9. return 0;
10. }
11. */
13. #include <cpprest/http_client.h>
14. #include <cpprest/json.h>
16. //#include <http_client.h>
17. #include <iostream>
18. //#include <json.h>
20. using namespace web;
21. using namespace web::http;
22. using namespace web::http::client;
24. using namespace std;
26. // Retrieves a JSON value from an HTTP request.
27. pplx::task<void> RequestJSONValueAsync()
28. {
29. // TODO: To successfully use this example, you must perform the request
30. // against a server that provides JSON data.
31. // This example fails because the returned Content-Type is text/html and not application/json.
32. //http_client client(L"http://www.fourthcoffee.com");
33. http_client client(L"http://www.fourthcoffee.com");
34. return client.request(methods::GET).then([](http_response response) -> pplx::task<json::value>
35. {
36. if (response.status_code() == status_codes::OK)
37. {
38. wcout<< response.extract_string().get().c_str()<<endl;
39. return response.extract_json();
40. }
42. // Handle error cases, for now return empty json value...
43. return pplx::task_from_result(json::value());
44. })
45. .then([](pplx::task<json::value> previousTask)
46. {
47. try
48. {
49. const json::value& v = previousTask.get();
50. // Perform actions here to process the JSON value...
51. }
52. catch (const http_exception& e)
53. {
54. // Print error.
55. wostringstream ss;
56. ss << e.what() << endl;
57. wcout << ss.str();
58. }
59. });
61. /* Output:
62. Content-Type must be application/json to extract (is: text/html)
63. */
64. }
66. // Demonstrates how to iterate over a JSON object.
67. void IterateJSONValue()
68. {
69. // Create a JSON object.
70. json::value obj;
71. obj[L"key1"] = json::value::boolean(false);
72. obj[L"key2"] = json::value::number(44);
73. obj[L"key3"] = json::value::number(43.6);
74. obj[L"key4"] = json::value::string(U("str"));
77. // Loop over each element in the object.
78. for (auto iter = obj.as_object().cbegin(); iter != obj.as_object().cend(); ++iter)
79. {
80. // Make sure to get the value as const reference otherwise you will end up copying
81. // the whole JSON value recursively which can be expensive if it is a nested object.
83. //const json::value &str = iter->first;
84. //const json::value &v = iter->second;
86. const auto &str = iter->first;
87. const auto &v = iter->second;
89. // Perform actions here to process each string and value in the JSON object...
90. std::wcout << L"String: " << str.c_str() << L", Value: " << v.serialize() << endl;
91. }
93. /* Output:
94. String: key1, Value: false
95. String: key2, Value: 44
96. String: key3, Value: 43.6
97. String: key4, Value: str
98. */
99. }
101. int wmain()
102. {
103. // This example uses the task::wait method to ensure that async operations complete before the app exits.
104. // In most apps, you typically don?t wait for async operations to complete.
106. wcout << L"Calling RequestJSONValueAsync..." << endl;
107. RequestJSONValueAsync().wait();
109. wcout << L"Calling IterateJSONValue..." << endl;
110. IterateJSONValue();
112. getchar();
113. }

編譯，運行，結果：

.............

d)/*]]>*/</script></body></html>
Calling IterateJSONValue...
String: key1, Value: false
String: key2, Value: 44
String: key3, Value: 43.600000000000001
String: key4, Value: "str"

C++ REST SDK i