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.
Перейти к файлу
Kumamon38 0f45af1513 add ping and pong to message handler (#1143)
Add ping and pong to message handler, and optional pong timeout
2019-06-13 12:40:00 -07:00
.vscode Add uri_builder::append_path_raw(...) to allow adding elements to path intentionally beginning with '/' ("//" will results in the final path value) (#958) 2018-11-12 10:44:41 -08:00
Build_android Fix broken CI Builds (#1156) 2019-06-12 18:43:31 -07:00
Build_iOS Fix broken CI Builds (#1156) 2019-06-12 18:43:31 -07:00
Release add ping and pong to message handler (#1143) 2019-06-13 12:40:00 -07:00
vcpkg@b7d6160b80 Fix broken CI Builds (#1156) 2019-06-12 18:43:31 -07:00
.clang-format clang-format cpprestsdk (#1005) 2018-12-20 17:02:57 -08:00
.gitignore Enable Android build in CI, update NDK to 17c. (#922) 2018-10-18 10:20:50 -07:00
.gitmodules Update embedded websockets to 0.8.1 and use submodule instead of checkin (#921) 2018-10-16 15:26:21 -07:00
CMakeLists.txt Enable testing from root directory (#1064) 2019-03-19 11:52:51 -07:00
CONTRIBUTORS.txt json: {"meow"} is not a valid object (#1130) 2019-05-07 10:43:33 -07:00
README.md Add install instructions for Fedora (#919) 2018-10-16 00:38:44 -07:00
ThirdPartyNotices.txt Update ThirdPartyNotices.txt to only cover websocketpp, since boost and openssl are not checked in 2016-10-18 12:30:28 -07:00
azure-pipelines.yml Fix broken CI Builds (#1156) 2019-06-12 18:43:31 -07:00
changelog.md Mint v2.10.13. (#1122) 2019-04-24 22:16:37 -07:00
license.txt Update license to MIT 2016-10-18 12:27:38 -07:00

README.md

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

Vcpkg package
Homebrew package
Ubuntu 18.04 package
Fedora Rawhide package
openSUSE Tumbleweed package
Debian Testing package

Build Status

With vcpkg on Windows

PS> vcpkg install cpprestsdk cpprestsdk:x64-windows

With apt-get on Debian/Ubuntu

$ sudo apt-get install libcpprest-dev

With dnf on Fedora

$ sudo dnf install cpprest-devel

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 an issue in our issue tracker.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.