2021-03-23 23:35:45 +13:00
## Getting Started
### Initialize & Make API Request
2023-07-08 00:57:44 +12:00
Once you have installed the package, it is extremely easy to get started with the SDK; all you need to do is import the package in your code, set your Appwrite credentials, and start making API calls. Below is a simple example:
2021-03-23 23:35:45 +13:00
```csharp
using Appwrite;
2023-07-08 00:57:44 +12:00
using Appwrite.Services;
using Appwrite.Models;
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
var client = new Client()
.SetEndpoint("http://cloud.appwrite.io/v1") // Make sure your endpoint is accessible
.SetProject("5ff3379a01d25") // Your project ID
.SetKey("cd868db89") // Your secret API key
.SetSelfSigned(); // Use only on dev mode with a self-signed SSL cert
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
var users = new Users(client);
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
var user = await users.Create(
userId: ID.Unique(),
email: "email@example.com",
password: "password",
name: "name");
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
Console.WriteLine(user.ToMap());
2021-03-23 23:35:45 +13:00
```
2021-03-26 21:00:50 +13:00
### Error Handling
2023-07-08 00:57:44 +12:00
The Appwrite .NET SDK raises an `AppwriteException` object with `message` , `code` , and `response` properties. You can handle any errors by catching `AppwriteException` and presenting the `message` to the user or handling it yourself based on the provided error information. Below is an example.
2021-03-26 21:00:50 +13:00
```csharp
2023-07-08 00:57:44 +12:00
var users = new Users(client);
2021-03-26 21:00:50 +13:00
2023-07-08 00:57:44 +12:00
try
{
var user = await users.Create(
userId: ID.Unique(),
email: "email@example.com",
password: "password",
name: "name");
}
catch (AppwriteException e)
{
Console.WriteLine(e.Message);
2021-03-26 21:00:50 +13:00
}
```
2021-03-23 23:35:45 +13:00
### Learn more
2021-07-07 22:25:49 +12:00
You can use the following resources to learn more and get help
2021-03-23 23:35:45 +13:00
- 🚀 [Getting Started Tutorial ](https://appwrite.io/docs/getting-started-for-server )
- 📜 [Appwrite Docs ](https://appwrite.io/docs )
- 💬 [Discord Community ](https://appwrite.io/discord )
2023-07-08 00:57:44 +12:00
- 🚂 [Appwrite .NET Playground ](https://github.com/appwrite/playground-for-dotnet )