Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Microsoft/cpprestsdk

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.
https://github.com/Microsoft/cpprestsdk

async asynchronous-tasks cloud cpp cpp-library cpp11 http oauth oauth2 sdk tasks websockets

Last synced: 8 days ago
JSON representation

Host: GitHub
URL: https://github.com/Microsoft/cpprestsdk
Owner: microsoft
License: other
Created: 2014-08-21T20:57:45.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2024-08-06T13:42:20.000Z (3 months ago)
Last Synced: 2024-10-13T11:40:50.598Z (21 days ago)
Topics: async, asynchronous-tasks, cloud, cpp, cpp-library, cpp11, http, oauth, oauth2, sdk, tasks, websockets
Language: C++
Homepage:
Size: 10.6 MB
Stars: 7,993
Watchers: 424
Forks: 1,654
Open Issues: 862
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- License: license.txt
- Security: SECURITY.md

Awesome Lists containing this project

README

        **cpprestsdk is in maintenance mode and we do not recommend its use in new projects. We will continue to fix critical bugs and address security issues.**

## 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](https://repology.org/badge/version-for-repo/vcpkg/cpprestsdk.svg)](https://repology.org/metapackage/cpprestsdk)

[![Homebrew package](https://repology.org/badge/version-for-repo/homebrew/cpprestsdk.svg)](https://repology.org/metapackage/cpprestsdk)

[![Ubuntu 18.04 package](https://repology.org/badge/version-for-repo/ubuntu_18_04/cpprestsdk.svg)](https://repology.org/metapackage/cpprestsdk)

[![Fedora Rawhide package](https://repology.org/badge/version-for-repo/fedora_rawhide/cpprestsdk.svg)](https://repology.org/metapackage/cpprestsdk)

[![openSUSE Tumbleweed package](https://repology.org/badge/version-for-repo/opensuse_tumbleweed/cpprestsdk.svg)](https://repology.org/metapackage/cpprestsdk)

[![Debian Testing package](https://repology.org/badge/version-for-repo/debian_testing/cpprestsdk.svg)](https://repology.org/metapackage/cpprestsdk)

[![Build Status](https://dev.azure.com/vclibs/cpprestsdk/_apis/build/status/Microsoft.cpprestsdk.Ubuntu)](https://dev.azure.com/vclibs/cpprestsdk/_build/latest?definitionId=1)

With [vcpkg](https://github.com/Microsoft/vcpkg) on Windows

```

PS> vcpkg install cpprestsdk cpprestsdk:x64-windows

```

With [apt-get](https://launchpad.net/ubuntu/+source/casablanca/2.8.0-2build2) on Debian/Ubuntu

```

$ sudo apt-get install libcpprest-dev

```

With [dnf](https://apps.fedoraproject.org/packages/cpprest) on Fedora

```

$ sudo dnf install cpprest-devel

```

With [brew](https://github.com/Homebrew/homebrew-core/blob/master/Formula/cpprestsdk.rb) on OSX

```

$ brew install cpprestsdk

```

With [NuGet](https://www.nuget.org/packages/cpprestsdk.android/) 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](https://github.com/Microsoft/cpprestsdk/wiki).

Once you have the library, look at our [tutorial](https://github.com/Microsoft/cpprestsdk/wiki/Getting-Started-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

cmake_minimum_required(VERSION 3.9)

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](https://visualstudio.microsoft.com/) 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](https://github.com/Microsoft/cpprestsdk/issues).  

Big or small we'd like to take your [contributions](https://github.com/Microsoft/cpprestsdk/wiki/Make-a-contribution-and-report-issues) back to help improve the C++ Rest SDK for everyone.

## 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](https://github.com/Microsoft/cpprestsdk/issues).  

### Quick Links

*   [FAQ](https://github.com/Microsoft/cpprestsdk/wiki/FAQ)

*   [Documentation](https://github.com/Microsoft/cpprestsdk/wiki)

*   [Issue Tracker](https://github.com/Microsoft/cpprestsdk/issues)

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.