|
1 | | -# DocuSign.Maestro - the C# library for the Maestro API |
| 1 | +# The Official Docusign Maestro C# Client SDK |
2 | 2 |
|
3 | | -Maestro authors and executes experiences that allow non-coders the ability to define Simple Business Process without having to write code and to deploy them seamlessly without having to have development expertise |
| 3 | +[![Nuget version][nuget-image]][nuget-url] |
| 4 | +[![Nuget downloads][downloads-image]][downloads-url] |
4 | 5 |
|
5 | | -This C# SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project: |
| 6 | +Maestro authors and executes experiences that allow non-coders the ability to define Simple Business Process without having to write code and to deploy them seamlessly without having to have development expertise. |
6 | 7 |
|
7 | | -- Build package: io.swagger.codegen.languages.CSharpClientCodegen |
8 | | - For more information, please visit [https://developers.docusign.com/](https://developers.docusign.com/) |
| 8 | +## Version Information |
| 9 | +- **API version**: 1.0.0 |
| 10 | +- **Latest SDK version (Including prerelease)**: 1.0.0-rc2 |
9 | 11 |
|
10 | | -## Frameworks supported |
11 | | -- .NET 4.0 or later |
12 | | -- Windows Phone 7.1 (Mango) |
| 12 | +## Requirements |
| 13 | +* Microsoft .NET version 4.6.2+ (4.7 recommended) |
| 14 | +* Free [developer account](https://go.docusign.com/o/sandbox/?postActivateUrl=https://developers.docusign.com/) |
| 15 | + |
| 16 | +## Compatibility |
| 17 | +* .NET Standard 2.0. See [.NET Standard Selector](https://immo.landwerth.net/netstandard-versions/) for details on versioning for the individual components in .NET Standard. |
| 18 | +* .NET Core 2.0 or above. |
| 19 | +* Microsoft .NET version 4.6.2+. |
| 20 | +* TLS 1.2 |
| 21 | + |
| 22 | +## Installation |
| 23 | +This SDK is provided as open source, which enables you to customize its functionality to suit your particular use case. To do so, download or clone the repository. If the SDK’s given functionality meets your integration needs, or if you’re working through our [code examples](https://developers.docusign.com/docs/maestro-api/how-to/) from the [Docusign Developer Center](https://developers.docusign.com/), you merely need to install it by following the instructions below. |
| 24 | + |
| 25 | +### NuGet Package Manager: |
| 26 | +1. Create a new C# project, or open an existing one. |
| 27 | +2. Select **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution.** |
| 28 | +3. Search for **DocuSign**. |
| 29 | +4. Select **DocuSign.Maestro**. |
| 30 | +5. Select the check box next to your project name. |
| 31 | +6. Click **Install.** |
| 32 | + |
| 33 | +### Package Manager Console: |
| 34 | +1. Create a new C# project, or open an existing one. |
| 35 | +2. Open the **Package Manager Console** by either method: |
| 36 | + 1. Clicking **Package Manager Console** along the bottom of Visual Studio |
| 37 | + 2. Clicking **Tools** -> **NuGet Package Manager** -> **Package Manager Console** |
| 38 | +3. In the **Package Manager Console**, type: **Install-Package DocuSign.Maestro** |
13 | 39 |
|
14 | 40 | ## Dependencies |
15 | | -- [Json.NET](https://www.nuget.org/packages/Newtonsoft.Json/) - 13.0.1 or later |
16 | | - |
17 | | -The DLLs included in the package may not be the latest version. We recommned using [NuGet] (https://docs.nuget.org/consume/installing-nuget) to obtain the latest version of the packages: |
18 | | -``` |
19 | | -Install-Package Newtonsoft.Json |
20 | | -``` |
21 | | - |
22 | | - |
23 | | -## Getting Started |
24 | | - |
25 | | -```csharp |
26 | | -using System; |
27 | | -using System.Diagnostics; |
28 | | -using DocuSign.Maestro.Api; |
29 | | -using DocuSign.Maestro.Client; |
30 | | -using DocuSign.Maestro.Model; |
31 | | - |
32 | | -namespace Example |
33 | | -{ |
34 | | - public class Example |
35 | | - { |
36 | | - public void main() |
37 | | - { |
38 | | - |
39 | | - // Configure OAuth2 access token for authorization: DSAuth |
40 | | - Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN"; |
41 | | - // Configure API key authorization: DSBearerAuth |
42 | | - Configuration.Default.ApiKey.Add("Authorization", "YOUR_API_KEY"); |
43 | | - // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed |
44 | | - // Configuration.Default.ApiKeyPrefix.Add("Authorization", "Bearer"); |
45 | | -
|
46 | | - var apiInstance = new WorkflowInstanceManagementApi(); |
47 | | - var accountId = new Guid?(); // Guid? | Account ID |
48 | | - var instanceId = new Guid?(); // Guid? | DS Workflow Instance Id (dacId) |
49 | | -
|
50 | | - try |
51 | | - { |
52 | | - // Cancels a running workflow instance. |
53 | | - CancelResponse result = apiInstance.CancelWorkflowInstance(accountId, instanceId); |
54 | | - Debug.WriteLine(result); |
55 | | - } |
56 | | - catch (Exception e) |
57 | | - { |
58 | | - Debug.Print("Exception when calling WorkflowInstanceManagementApi.CancelWorkflowInstance: " + e.Message ); |
59 | | - } |
60 | | - } |
61 | | - } |
62 | | -} |
63 | | -``` |
64 | | - |
65 | | -## Documentation for Authorization |
66 | | - |
67 | | - |
68 | | -### DSAuth |
69 | | - |
70 | | -- **Type**: OAuth |
71 | | -- **Flow**: accessCode |
72 | | -- **Authorization URL**: https://account-tk1.tk.docusign.dev/oauth/auth |
73 | | -- **Scopes**: |
74 | | - - aow_manage: Manage workflows scope |
75 | | - |
76 | | -### DSBearerAuth |
77 | | - |
78 | | -- **Type**: API key |
79 | | -- **API key parameter name**: Authorization |
80 | | -- **Location**: HTTP header |
| 41 | +This client has the following external dependencies: |
| 42 | + |
| 43 | +### .NET Standard v2 and .NET Core: |
| 44 | +* Newtonsoft.Json v13.0.3 |
| 45 | +* BouncyCastle.Cryptography v2.3.0 |
| 46 | +* System.ComponentModel.Annotations v5.0.0 |
| 47 | +* Microsoft.IdentityModel.JsonWebTokens v7.5.1 |
| 48 | + |
| 49 | +### .NET Framework, version 4.6.2: |
| 50 | +* Newtonsoft.Json v13.0.3 |
| 51 | +* BouncyCastle.Cryptography v2.3.0 |
| 52 | +* System.ComponentModel.Annotations v5.0.0 |
| 53 | +* Microsoft.IdentityModel.JsonWebTokens v7.5.1 |
| 54 | + |
| 55 | +## Code examples |
| 56 | +Explore our GitHub repository for the [Launcher](https://github.com/docusign/code-examples-csharp/), a self-executing package housing code examples for the Maestro C# SDK. This package showcases several common use cases and their respective source files. Additionally, you can download a version preconfigured for your Docusign developer account from [Quickstart](https://developers.docusign.com/docs/esign-rest-api/quickstart/). These examples support both the [Authorization Code Grant](https://developers.docusign.com/platform/auth/authcode/) and [JSON Web Token (JWT)](https://developers.docusign.com/platform/auth/jwt/) authentication workflows. |
| 57 | + |
| 58 | +## OAuth implementations |
| 59 | +For details regarding which type of OAuth grant will work best for your Docusign integration, see [Choose OAuth Type](https://developers.docusign.com/platform/auth/choose/) in the [Docusign Developer Center](https://developers.docusign.com/). |
| 60 | + |
| 61 | +For security purposes, Docusign recommends using the [Authorization Code Grant](https://developers.docusign.com/platform/auth/authcode/) flow. |
| 62 | + |
| 63 | +## Support |
| 64 | +Log issues against this client through GitHub. We also have an [active developer community on Stack Overflow](https://stackoverflow.com/questions/tagged/docusignapi). |
| 65 | + |
| 66 | +## License |
| 67 | +The Docusign Maestro C# Client SDK is licensed under the [MIT License](https://github.com/docusign/docusign-maestro-csharp-client/blob/master/LICENSE). |
| 68 | + |
| 69 | +## Additional resources |
| 70 | +* [Docusign Developer Center](https://developers.docusign.com/) |
| 71 | +* [Docusign API on Twitter](https://twitter.com/docusignapi) |
| 72 | +* [Docusign For Developers on LinkedIn](https://www.linkedin.com/showcase/docusign-for-developers/) |
| 73 | +* [Docusign For Developers on YouTube](https://www.youtube.com/channel/UCJSJ2kMs_qeQotmw4-lX2NQ) |
| 74 | + |
| 75 | +[nuget-image]: https://img.shields.io/nuget/v/DocuSign.Maestro.svg?style=flat |
| 76 | +[nuget-url]: https://www.nuget.org/packages/DocuSign.Maestro |
| 77 | +[downloads-image]: https://img.shields.io/nuget/dt/DocuSign.Maestro.svg?style=flat |
| 78 | +[downloads-url]: https://www.nuget.org/packages/DocuSign.Maestro |
0 commit comments