1
0
Fork 0
mirror of synced 2024-08-03 12:32:28 +12:00
appwrite/docs/sdks/dotnet/GETTING_STARTED.md

55 lines
1.8 KiB
Markdown
Raw Normal View History

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()
2023-07-08 02:34:01 +12:00
.SetEndpoint("http://cloud.appwrite.io/v1")
2023-07-08 00:57:44 +12:00
.SetProject("5ff3379a01d25") // Your project ID
2023-07-08 02:34:01 +12:00
.SetKey("cd868db89"); // Your secret API key
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(
2023-10-20 04:38:47 +13:00
userId: ID.Unique(),
2023-10-19 08:27:12 +13:00
email: "email@example.com",
phone: "+123456789",
password: "password",
2023-10-18 01:49:02 +13:00
name: "Walter O'Brien");
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(
2023-10-20 04:38:47 +13:00
userId: ID.Unique(),
2023-10-19 08:27:12 +13:00
email: "email@example.com",
phone: "+123456789",
password: "password",
2023-10-18 01:49:02 +13:00
name: "Walter O'Brien");
2023-07-08 00:57:44 +12:00
}
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)