Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/unfoldml/ms-graph-api

Haskell SDK to the Microsoft APIs
https://github.com/unfoldml/ms-graph-api

azure cloud-api microsoft-azure-sdk microsoft-graph-api microsoft-graph-sdk microsoft-identity rest-api-client

Last synced: 2 months ago
JSON representation

Haskell SDK to the Microsoft APIs

Awesome Lists containing this project

README

        

# Haskell SDK for the Microsoft APIs

[![CI](https://github.com/unfoldml/ms-graph-api/actions/workflows/haskell.yml/badge.svg)](https://github.com/unfoldml/ms-graph-api/actions/workflows/haskell.yml)

| Service | Package name | Release |
|---|---|---|
| [Identity / Active Directory](https://learn.microsoft.com/en-us/graph/azuread-identity-access-management-concept-overview) | `ms-auth` | [![Hackage](https://img.shields.io/hackage/v/ms-auth?style=for-the-badge)](https://hackage.haskell.org/package/ms-auth) |
| [Graph](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0) | `ms-graph-api` | [![Hackage](https://img.shields.io/hackage/v/ms-graph-api?style=for-the-badge)](https://hackage.haskell.org/package/ms-graph-api) |
| [Azure](https://learn.microsoft.com/en-us/rest/api/azure/) | `ms-azure-api` |[![Hackage](https://img.shields.io/hackage/v/ms-azure-api?style=for-the-badge)](https://hackage.haskell.org/package/ms-azure-api) |

## Introduction

We provide separate libraries for authentication (`ms-auth`), Graph (`ms-graph-api`) and Azure (`ms-azure-api`) since they cater to different use cases. Both the Graph and Azure SDKs import `ms-auth`.

## Examples

* OAuth flow : see `ms-graph-api-test/app/Main.hs`
* Azure bot service : see `ms-azure-api-test/app/Main.hs`

## Status

This library is still in development, so expect missing functionality.
If there's anything you would like to see added, feel free to
[open an issue](https://github.com/unfoldml/ms-graph-api/issues/new), or even better contribute some code.
In general, since the API surface is quite large, features will be added to this library on a need basis.

## Evolution of the library

Some breaking changes might also be introduced as the library matures.

We adhere to the [Package Versioning Policy](https://pvp.haskell.org/): major breaking changes or API refactors are signaled by increasing the first major version number (i.e. 0.0.0.0 -> 1.0.0.0 ) whereas less significant ones are indicated by increasing the second one (0.0.0.0 -> 0.1.0.0).

Significant changes in the SDK will be documented in the respective CHANGELOG.

## LICENSE

BSD 3

## Copyright

(c) 2023-, Marco Zocca, UnfoldML AB